Data Domain Boost Admin Guide 759-0010-0003

122
Backup Recovery Systems Division Data Domain LLC 2421 Mission College Boulevard, Santa Clara, CA 95054 866-WE-DDUPE; 408-980-4800 Data Domain Boost for OpenStorage 2.3 Administration Guide 759-0010-0003 Revision A November 17, 2010

Transcript of Data Domain Boost Admin Guide 759-0010-0003

Page 1: Data Domain Boost Admin Guide 759-0010-0003

Data Domain Boost for OpenStorage 2.3 Administration Guide

Backup Recovery Systems DivisionData Domain LLC2421 Mission College Boulevard, Santa Clara, CA 95054866-WE-DDUPE; 408-980-4800

759-0010-0003 Revision ANovember 17, 2010

Page 2: Data Domain Boost Admin Guide 759-0010-0003

2

Copyright © 2010 EMC Corporation. All Rights Reserved.

EMC believes the information in this publication is accurate as of its publication date. The information is subject to change without notice.

THE INFORMATION IN THIS PUBLICATION IS PROVIDED “AS IS.” EMC CORPORATION MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND WITH RESPECT TO THE INFORMATION IN THIS PUBLICATION, AND SPECIFICALLY DISCLAIMS IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

Use, copying, and distribution of any EMC software described in this publication requires an applicable software license.

EMC, Data Domain, and Global Compression are registered trademarks or trademarks of EMC Corporation in the United States and/or other countries.

All other trademarks used herein are the property of their respective owners.

Page 3: Data Domain Boost Admin Guide 759-0010-0003

Contents

Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

About This Guide. . . . . . . . . . . . . . . . . . . . . . . . . . . 9Related Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

DD Boost for OpenStorage Backup Application Documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Access to Documents at Data Domain . . . . . . . . . . . . . 11

Access Data Domain Documents . . . . . . . . . . . . . . 11

Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Data Domain Support . . . . . . . . . . . . . . . . . . . . . . . . . . 13

1 Introducing Data Domain Boost for OpenStorage . . .15Supported Configurations . . . . . . . . . . . . . . . . . . . . . . . 16

2 Installing Data Domain Boost for OpenStorage . . . . .17Installation Overview . . . . . . . . . . . . . . . . . . . . . . . . . . 17

OST Plug-in and DD OS Upgrades . . . . . . . . . . . . . . . . 18

Firewalls and Ports . . . . . . . . . . . . . . . . . . . . . . . . . 18

Enabling DD Boost on a Data Domain System . . . . . . . . 18

NetBackup Installation . . . . . . . . . . . . . . . . . . . . . . . . . 19

Installing the OST Plug-In on Media Servers . . . . . . . . . 20

DD Boost for OpenStorage Administration Guide 3

Page 4: Data Domain Boost Admin Guide 759-0010-0003

NetBackup Services . . . . . . . . . . . . . . . . . . . . . . . . .23

NetBackup UNIX Services . . . . . . . . . . . . . . . . . . .24

NetBackup Windows Services . . . . . . . . . . . . . . . . .24

Backup Exec Installation . . . . . . . . . . . . . . . . . . . . . . . .24

Installing the Plug-In on Media Servers . . . . . . . . . . . . .24

Backup Exec Services . . . . . . . . . . . . . . . . . . . . . . . .26

Tuning Windows Media Servers for Performance. . . . . . . . .28

Uninstalling the Windows Plug-in. . . . . . . . . . . . . . . . . . .29

3 Data Domain Boost Features . . . . . . . . . . . . . . . . 31Distributed segment processing. . . . . . . . . . . . . . . . . . . .31

Advanced Load Balancing and Link Failover . . . . . . . . . . . .35

Configuration Restrictions . . . . . . . . . . . . . . . . . . . . .37

Encrypted Optimized Duplication . . . . . . . . . . . . . . . . . .38

Low-Bandwidth Optimization Option . . . . . . . . . . . . . . . .39

4 Data Domain Boost for OpenStorage Configuration . 41Configuring the Data Domain System . . . . . . . . . . . . . . . .41

Creating Storage Units . . . . . . . . . . . . . . . . . . . . . . .42

Configuring distributed segment processing . . . . . . . . .42

Configuring Advanced Load Balancing and Link Failover .43

Enabling Low-Bandwidth Optimization . . . . . . . . . . . .44

Enabling Encrypted Optimized Duplication . . . . . . . . . .45

Configuring a Media Server. . . . . . . . . . . . . . . . . . . . . . .46

4

Page 5: Data Domain Boost Admin Guide 759-0010-0003

NetBackup Configuration . . . . . . . . . . . . . . . . . . . . . 46

Concurrent Connection Limit . . . . . . . . . . . . . . . . 47

Registering Each Data Domain System . . . . . . . . . . 47

Adding Credentials . . . . . . . . . . . . . . . . . . . . . . . 48

Creating Disk Pools . . . . . . . . . . . . . . . . . . . . . . . 48

Creating Storage Units . . . . . . . . . . . . . . . . . . . . 52

Creating a Backup Policy . . . . . . . . . . . . . . . . . . . 55

Configuring Buffers . . . . . . . . . . . . . . . . . . . . . . 55

Configuring Optimized Duplication . . . . . . . . . . . . 57

Using Storage Lifecycle Policies to Automate Optimized Duplication . . . . . . . . . . . . . . . . . . . . . . . . . 58

Backup Exec Configuration . . . . . . . . . . . . . . . . . . . . 62

Creating a Logon Account . . . . . . . . . . . . . . . . . . 63

Configuring Devices . . . . . . . . . . . . . . . . . . . . . . 63

Configuring Optimized Duplication . . . . . . . . . . . . 66

5 Using the DD Boost Commands . . . . . . . . . . . . . .81ddboost Command Options . . . . . . . . . . . . . . . . . . . . . . 82

enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

destroy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

disable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

DD Boost for OpenStorage Administration Guide 5

Page 6: Data Domain Boost Admin Guide 759-0010-0003

ifgroup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .83

ifgroup add interface . . . . . . . . . . . . . . . . . . . . . .83

ifgroup del interface . . . . . . . . . . . . . . . . . . . . . .84

ifgroup disable . . . . . . . . . . . . . . . . . . . . . . . . . .84

ifgroup enable . . . . . . . . . . . . . . . . . . . . . . . . . .84

ifgroup show config . . . . . . . . . . . . . . . . . . . . . . .84

ifgroup reset . . . . . . . . . . . . . . . . . . . . . . . . . . .85

ifgroup status . . . . . . . . . . . . . . . . . . . . . . . . . . .85

file-replication . . . . . . . . . . . . . . . . . . . . . . . . . . . .85

file-replication option reset . . . . . . . . . . . . . . . . .85

file-replication option set . . . . . . . . . . . . . . . . . . .85

file-replication option show . . . . . . . . . . . . . . . . .86

file-replication reset stats . . . . . . . . . . . . . . . . . .86

file-replication show active . . . . . . . . . . . . . . . . . .86

file-replication show detailed-file-history . . . . . . . .87

ddboost file-replication show detailed-file-history [duration duration{day | hr}] . . . . . . . . . . . . . .87

file-replication show detailed-history . . . . . . . . . . .87

ddboost file-replication show detailed-history [duration duration{day | hr}] [interval hr] . . . . . . . . . . . .87

file-replication show history . . . . . . . . . . . . . . . . .88

file-replication show file-history . . . . . . . . . . . . . .88

file-replication show performance . . . . . . . . . . . . .89

file-replication show stats . . . . . . . . . . . . . . . . . .90

option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .91

option reset . . . . . . . . . . . . . . . . . . . . . . . . . . . .91

option set . . . . . . . . . . . . . . . . . . . . . . . . . . . . .91

option show . . . . . . . . . . . . . . . . . . . . . . . . . . . .92

6

Page 7: Data Domain Boost Admin Guide 759-0010-0003

reset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

reset stats . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93

show connections . . . . . . . . . . . . . . . . . . . . . . . . 93

show histogram . . . . . . . . . . . . . . . . . . . . . . . . . 95

show stats . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95

status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

storage-unit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

storage-unit create . . . . . . . . . . . . . . . . . . . . . . 96

storage-unit delete . . . . . . . . . . . . . . . . . . . . . . 96

storage-unit show . . . . . . . . . . . . . . . . . . . . . . . 96

user-name. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

reset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

6 Administration . . . . . . . . . . . . . . . . . . . . . . . . . .99Data Domain System Administration . . . . . . . . . . . . . . . . 99

Restricting Export Permissions to DD Boost . . . . . . . . . 99

Optimized Duplication Version Compatibility . . . . . . . 101

Modifying an Interface Group . . . . . . . . . . . . . . . . . 101

Removing Advanced Load Balancing and Link Failover Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

NetBackup Administration . . . . . . . . . . . . . . . . . . . . . 104

Network Time-Outs . . . . . . . . . . . . . . . . . . . . . 104

Grouping Storage Units to Provide Failover . . . . . . 105

Backup Exec Administration . . . . . . . . . . . . . . . . . . . . 106

DD Boost for OpenStorage Administration Guide 7

Page 8: Data Domain Boost Admin Guide 759-0010-0003

7 Basic Troubleshooting . . . . . . . . . . . . . . . . . . . 109General Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . 109

Data Domain System Settings for File-Replication. . . . . . . 110

NetBackup Troubleshooting . . . . . . . . . . . . . . . . . . . . . 110

Unable to Delete the Data Domain System . . . . . . . . . 110

Error Logging on the Media Servers . . . . . . . . . . . . . . 113

Resolving Failed Backups on Media Servers . . . . . . . . . 114

NetBackup Backup Jobs Fail on Solaris Media Servers . . 117

Optimized Duplication Job Fails . . . . . . . . . . . . . . . . 118

Backup Exec Troubleshooting . . . . . . . . . . . . . . . . . . . . 118

Basic Troubleshooting. . . . . . . . . . . . . . . . . . . . . . . 118

8

Page 9: Data Domain Boost Admin Guide 759-0010-0003

About This Guide

This guide explains how to install, configure, and use Data Domain Boost for OpenStorage with Data Domain systems.

Related DocumentsThe following Data Domain system documents provide additional information:

• DD OS Release Notes Version 5.0

• DD OS 5.0 Initial Configuration Guide

• DD OS 5.0 Administration Guide

• DD OS 5.0 Command Reference

• DD OS 5.0 Command Reference Guide

• Data Domain Expansion Shelf Hardware Guide

• The Data Domain system installation and setup guides for each of the supported platforms (for example DD880, DD690g, and so forth).

DD Boost for OpenStorage Backup Application Documentation

Documentation for backup applications is available through the Symantec web site.

NetBackup Documentation

From the general Symantec support page, navigate to the NetBackup Server product page and search the knowledge base for Documentation.

DD Boost for OpenStorage Administration Guide 9

Page 10: Data Domain Boost Admin Guide 759-0010-0003

Note: To locate a document, enter its title as a search criterion in your favorite search engine.

• NetBackup Shared Storage Guide

• NetBackup Troubleshooting Guide

• NetBackup Commands for UNIX and Linux

• NetBackup Commands for Windows

See these NetBackup documents for more information:

• NetBackup Backup, Archive, and Restore Getting Started Guide

• NetBackup Administrator's Guide for UNIX and Linux (two volumes)

• NetBackup Administrator’s Guide for Windows (two volumes)

• Best Practices for using Storage Lifecycle Policies in NetBackup 6.5.3 and 6.5.4. ftp://exftpp.symantec.com/pub/support/products/NetBackup_Enterprise_Server/327648.pdf

• NetBackup 6.5 Hardware Compatibility List that includes information for supported OpenStorage servers can be found at http://seer.entsupport.symantec.com/docs/284599.htm

• NetBackup 7.x Hardware Compatibility List that includes information for supported OpenStorage servers can be found at http://seer.entsupport.symantec.com/docs/336875.htm

Symantec Backup Exec Documentation

This document is installed with the application:

• Symantec Backup Exec 2010 Administrator’s Guide

• Backup Exec 2010 Hardware Compatibility List that includes information for supported OpenStorage servers can be found at http://seer.entsupport.symantec.com/docs/329256.htm

10 About This Guide

Page 11: Data Domain Boost Admin Guide 759-0010-0003

Access to Documents at Data DomainThe Documentation page at https://my.datadomain.com/documentation provides access to three categories of documents that are related to use of Data Domain products:

• User guides, under Product Documentation.

• Guides for how to integrate Data Domain systems with backup applications, under Integration Documentation.

• Matrices that show which components are compatible with each other, under Compatibility Matrices:

• Data Domain hardware product numbers

• Data Domain operating system (DD OS) versions

• Backup software versions

• Backup software server and client operating system versions

Access Data Domain Documents

1. Log into the support portal at: https://my.datadomain.com/documentation.

2. To view end user documents, click Product Documentation and then perform the following steps:

a. Select the Data Domain model from the Platform list and click View.

b. On the row for the correct Data Domain operating system (DD OS) version, click View under Documentation.

c. Click the desired title.

3. To view integration-related documents, perform the following steps:

a. Click Integration Documentation.

b. Select a vendor from the Vendor menu.

c. Select the desired title from the list and click View.

DD Boost for OpenStorage Administration Guide 11

Page 12: Data Domain Boost Admin Guide 759-0010-0003

4. To view compatibility matrices, perform the following steps.

a. Click Compatibility Matrices.

b. Select the desired title from product menu and click View.

ConventionsThe following tables describe the typographical conventions used in this guide.The following table describes the typographical conventions used in this guide.

Typeface or Symbol

Usage Examples

Monospace Commands, command options, and parameters and computer output.

Use the config command to manage the Data Domain system configuration settings.

Monospace bold

Commands the user types at the command prompt (#).

Enter:# config setup

Monospace italic bold

Command variables the user types at the command prompt (#).

# log view file_name

Italic Book titles, and variables. Refer to the DD OS Command Reference Guide for complete descriptions of DD OS commands.

Pipe (|) and curly braces ({})

Choose (pipe) between a required argument (curly braces) in the CLI.

{arg1 | arg2}

Brackets ([]) and ellipses (...)

One or more (list with commas and ellipses) optional (bracket) arguments in the CLI.

[arg1, arg2, ...]

12 About This Guide

Page 13: Data Domain Boost Admin Guide 759-0010-0003

AudienceThis guide is for system administrators who are familiar with Symantec backup applications and general backup administration

Data Domain SupportTo resolve issues with Data Domain products, contact your contracted support provider or visit us online at https://my.datadomain.com.

DD Boost for OpenStorage Administration Guide 13

Page 14: Data Domain Boost Admin Guide 759-0010-0003

14 About This Guide

Page 15: Data Domain Boost Admin Guide 759-0010-0003

1 Introducing Data Domain Boost for OpenStorage

Data Domain Boost (DD Boost) for OpenStorage enables media servers to communicate with storage systems without the need for Data Domain storage systems to emulate tape. In the context of Symantec backup applications (NetBackup and Backup Exec), there are two components to the software:

• An OST plug-in that you install on each media server. This plug-in includes the DD Boost libraries for integrating with the DD Boost server running on the Data Domain system.

• The DD Boost server that runs on Data Domain systems. A Data Domain system can be a single Data Domain system, a gateway, or a Global Deduplication Array.

The backup application (NetBackup or Backup Exec) sets policies that control when backups and duplications occur. Administrators manage backup, duplication, and restores from a single console and can use all of the features of DD Boost, including WAN-efficient replicator software. The application manages all files (collections of data) in the catalog, even those created by the Data Domain system.

The Data Domain system exposes pre-made disk volumes called storage units to a DD Boost-enabled media server. Multiple media servers, each with the Data Domain OST plug-in, can use the same storage unit on a Data Domain system as a storage server. Each media server can run a different operating system, provided that it is supported by Data Domain.

Figure 1-1 shows an example configuration of Data Domain Boost for Open Storage using NetBackup.

DD Boost for OpenStorage Administration Guide 15

Page 16: Data Domain Boost Admin Guide 759-0010-0003

Figure 1-1: Data Domain Boost for OpenStorage Configuration Using NetBackup

Supported ConfigurationsData Domain supports DD Boost on the following Data Domain systems:

• Data Domain systems (DD5xx, DD6xx, DD8xx)

• Data Domain gateway systems (DD560g, DD580g, DD690g, DD880g)

• Data Domain Global Deduplication Array systems

The OST plug-in version must be compatible with your Data Domain system and backup application configurations. Data Domain does not support combinations other than those detailed in the DD Boost for OpenStorage Compatibility List, which is available from the Data Domain Support portal (https: //my.datadomain.com). Navigate to the Documentation > Compatibility List page and select DD Boost for OpenStorage Compatibility List.

16 Introducing Data Domain Boost for OpenStorage

Page 17: Data Domain Boost Admin Guide 759-0010-0003

2 Installing Data Domain Boost for OpenStorage

This chapter covers the following topics:

• Installation Overview on page 17

• NetBackup Installation on page 19

• Backup Exec Installation on page 24

• Tuning Windows Media Servers for Performance on page 28

Installation OverviewThe overall steps for installing Data Domain Boost are as follows:

1. Obtain the license required to enable DD Boost on the Data Domain system. You can purchase a DD Boost license key directly from EMC.

• The basic license allows you to back up and restore data.

• A separate replication license enables you to perform optimized duplication. You must obtain a replication license for both the source and destination Data Domain systems.

2. Enable and configure DD Boost on the Data Domain system. At a minimum, configuration includes specifying the DD Boost user name and password, and creating storage units.

3. Install the OST plug-in software on each media server.

4. After completing the installation steps described in this chapter, configure DD Boost as described in Chapter 3.

DD Boost for OpenStorage Administration Guide 17

Page 18: Data Domain Boost Admin Guide 759-0010-0003

OST Plug-in and DD OS UpgradesThe OST plug-in and the DD OS maintain compatibility as defined in the DD Boost for OpenStorage Compatibility List. Consult that list before upgrading either the OST plug-in or the DD OS.

To take advantage of new features in a DD OS release, upgrade the OST plug-in to a corresponding version. Although an older version of the OST plug-in maintains compatibility with a newer version of DD OS, it does not take advantage of the new functionality available in the DD OS. Perform the upgrade as described in Installing the OST Plug-In on Media Servers on page 20.

Note: This document illustrates the DD Boost configuration on Data Domain using commands in DD OS 5.0. If you are using a different version of DD OS with this version of the OST plug-in, see the corresponding DD OS version documentation for CLI details.

Firewalls and PortsThe Data Domain system as it is initially configured does not work through a firewall (a media server to a Data Domain system, or from one Data Domain system to another). If you need the Data Domain system to work in the presence of a firewall, contact your network support provider.

The following ports must be open in a firewall for DD Boost backups and optimized duplication to work:

• TCP 2049 (NFS)

• TCP 2051 (Replication)

• TCP 111 (NFS portmapper)

• TCP xxx (select a random port for NFS mountd)

Enabling DD Boost on a Data Domain SystemEvery Data Domain system that is enabled for Data Domain Boost must have a unique name. You can use the Data Domain system’s DNS name, which is always unique.

18 Installing Data Domain Boost for OpenStorage

Page 19: Data Domain Boost Admin Guide 759-0010-0003

Enable DD Boost

1. On the Data Domain system, log in as an administrative user.

2. Verify that the file system is enabled and running by entering:

# filesys status

The file system is enabled and running.

3. Add the DD Boost license using the license key that Data Domain provided:

# license add license_key

License “ABCE-BCDA-CDAB-DABC” added.

4. Set the DD Boost user by entering:

# ddboost set user-name ddboost-user

5. Enable DD Boost by entering:

# ddboost enable

DD Boost enabled

Notes:

Only one user can be configured for DD Boost access on a Data Domain system at a time. The username and password must have already been set up on the Data Domain system using the DD OS CLI command: user add username [password password]

For example, to add a user with a login name of jsmith and a password of usr256 with administrative privilege, enter:

# user add jsmith password usr256

• The user must be configured in the backup application in order to connect to the Data Domain system.

NetBackup InstallationThis section describes the commands used to install an OST plug-in within a NetBackup environment.

DD Boost for OpenStorage Administration Guide 19

Page 20: Data Domain Boost Admin Guide 759-0010-0003

NetBackup environments consist of media servers and a master server. The master server manages clients and media servers and can also function as a media server. The OST plug-in must be installed on each media server. If a master server is also configured as a media server, then the OST plug-in must also be installed on the master/media server.

Note: Commands that run on the command line can be entered on either the master or the media server. If you run commands from the master server, use the -media_server option to tell NetBackup where to direct the operation that queries the plug-in about the storage server’s properties.

This guide uses the NetBackup commands located in the following directories, which you need to add to your UNIX or Windows PATH.

Add these directories to the UNIX PATH/usr/openv/netbackup/bin

/usr/openv/netbackup/bin/admincmd

/usr/openv/volmgr/bin

Add these directory locations to the UNIX PATH$ export PATH=$PATH:/usr/openv/netbackup/bin: /usr/openv/netbackup/bin/admincmd:/usr/openv/volmgr/bin

Add these directory locations to the Windows PATH

$ PATH=%PATH%;C:\Program Files\Veritas\NetBackup\bin; C:\Program Files\Veritas\NetBackup\bin\admincmd; C:\Program Files\Veritas\Volmgr\bin

Installing the OST Plug-In on Media ServersThe OST plug-in software must be installed on media servers that need to access the Data Domain system. When you upgrade the

20 Installing Data Domain Boost for OpenStorage

Page 21: Data Domain Boost Admin Guide 759-0010-0003

UNIX OST plug-in, the previous version of the plug-in is overwritten; therefore, you do not have to remove it. There are no special instructions for uninstalling the OST plug-in on UNIX systems.

Install the UNIX plug-In 1. Download the latest version of the OST plug-in from the Data

Domain Support web site.

2. Save the file on the media server in a location of your choice.

3. Stop the backup application’s Remote Manager and Monitor Service (nbrmms) process if it is running by entering:

# nbrmms -terminate

4. Install the OST plug-in (a set of libraries in a gtar package.)

5. Use the tar command to uncompress the file:

# tar -vxf filename

6. The package also contains an installation script called install.sh, which verifies whether or not nbrmms has been stopped before starting the installation. Enter:

# install.sh -d directorypath

The directory path is optional. If you do not specify a directory path, the script uses /usr/openv/lib/ost-plugins, which is where the backup application normally looks for packages. The shared library files that the script installs are libstspiDataDomain.so and libstspiDataDomainMT.so.

7. If the plug-in already exists, you are prompted to enter y to proceed.

8. Restart the backup application’s nbrmms process by entering:

# nbrmms

Correct UNIX plug-in installation or update failure (AIX Media Servers)

1. Stop the NetBackup Remote Manager and Monitor Service (nbrmms).

DD Boost for OpenStorage Administration Guide 21

Page 22: Data Domain Boost Admin Guide 759-0010-0003

2. Enter:

# ./install.sh

a plugin already exists, do you want to proceed with installation? (y or n) y

Installing the Data Domain OpenStorage Client Libraries ...

cp libstspiDataDomain.so /usr/openv/lib/ost-plugins/libstspiDataDomain.so

cp: /usr/openv/lib/ost-plugins/libstspiDataDomain.so: Cannot open or remove a file containing a running program.

ERROR in copying libstspiDataDomain.so to /usr/openv/lib/ost-plugins/libstspiDataDomain.so, error = 1

The install script might fail and display an error message that indicates that the plug-in already exists. This failure occurs if a plug-in is already installed and is being replaced by another instance.

If the install script fails:

1. Execute the following command:

# /usr/sbin/slibclean

2. Enter:

# ./install.sh

Because the modules have now been unloaded from memory, the install.sh script should now run correctly.

Install the Windows plug-In The Windows plug-in installer is libstspiDataDomainSetup.exe. It supports 32- and 64-bit Windows plug-ins.

22 Installing Data Domain Boost for OpenStorage

Page 23: Data Domain Boost Admin Guide 759-0010-0003

Prepare for installation

1. Download the latest version of the Windows OST plug-in installer from the Data Domain Support web site.

2. Double-click the set-up executable to launch the installer.

The installer determines whether NetBackup is installed and whether its respective services are running. If the installer detects a service running it displays a message to this effect and exits.

3. Before starting the installation:

a. Stop any NetBackup services. Follow the instructions given in NetBackup Windows Services on page 24 to stop the service.

b. Remove any previous plug-in version using either the Windows Control Panel or libstspiDataDomainUninstall.exe.

Start the installation

1. If the services have been stopped, the installer displays the license agreement. Read the terms and Click I Agree to continue.

2. In the Choose Install Location dialog box, the correct destination folder is shown. This should not be changed. Click Install to start the installation.

A progress bar monitors the installation.

3. When the Installation is complete, you can click the Show details button to view the files installed and their location.

4. Restart all services. See NetBackup Windows Services on page 24.

5. Tune the Windows media server for performance. See Tuning Windows Media Servers for Performance on page 28.

NetBackup ServicesFollow the instructions for starting, stopping, and restarting UNIX or Windows services.

DD Boost for OpenStorage Administration Guide 23

Page 24: Data Domain Boost Admin Guide 759-0010-0003

NetBackup UNIX Services

Stop UNIX services

Enter:

# nbrmms -terminate

Start or restart UNIX services

Enter:

# nbrmms

NetBackup Windows Services

Start, stop, or restart Windows services

1. Go to Start > Control Panel > Administrative Tools > Services.

2. In the Services window, services are listed in alphabetical order by name. Locate the name NetBackup Remote Manager and Monitor Service. Its Status field shows the state of the service.

3. Select the service and right-click.

4. The menu that displays has options to Stop, Start, or Restart the service. Select the appropriate menu option.

Backup Exec InstallationThis section covers the following topics:

• Installing the Plug-In on Media Servers on page 24

• Backup Exec Services on page 26

Installing the Plug-In on Media ServersThe OST plug-in software must be installed on media servers that need to access the Data Domain system. Because Backup Exec supports OpenStorage only on Windows media servers, the following section covers instructions for Windows servers only.

24 Installing Data Domain Boost for OpenStorage

Page 25: Data Domain Boost Admin Guide 759-0010-0003

Install the Windows plug-InThe Windows plug-in installer is libstspiDataDomainSetup.exe. It supports 32- and 64-bit Windows plug-ins.

Prepare for installation

1. Download the latest version of the Windows OST plug-in installer from the Data Domain Support web site.

2. Double-click the set-up executable to launch the installer.

The installer determines whether Backup Exec is installed and whether its respective services are running. If the installer detects a service running it displays a message to this effect and exits.

3. Before starting the installation:

a. Stop any Backup Exec services. Follow the instructions given in Backup Exec Services on page 26 to stop the service.

b. Remove any previous plug-in version using either the Windows Control Panel or libstspiDataDomainUninstall.exe.

Start the installation

1. If the services have been stopped, the installer displays the license agreement. Read the terms and Click I Agree to continue.

2. In the Choose Install Location dialog box, the correct destination folder is shown. This should not be changed. Click Install to start the installation.

A progress bar monitors the installation.

3. When the Installation is complete, you can click the Show details button to view the files installed and their location.

4. Restart all services. See Backup Exec Services on page 26.

5. Tune the Windows media server for DD Boost performance. See Tuning Windows Media Servers for Performance on page 28.

DD Boost for OpenStorage Administration Guide 25

Page 26: Data Domain Boost Admin Guide 759-0010-0003

Verify Backup Exec deduplication option

1. From the Backup Exec menu bar, select Help from the About menu.

2. Select License Information. The Deduplication Option should be present in the dialog box. If it is not, re-run the Backup Exec installation and add the Backup Exec Server option.

Backup Exec Services

Start, Stop, or Restart Windows services

1. Within Backup Exec, go to Tools > Backup Exec Services.

2. In the Backup Exec Services Manager window, select the server in the list and click the appropriate services button on the right side of the dialog box.

26 Installing Data Domain Boost for OpenStorage

Page 27: Data Domain Boost Admin Guide 759-0010-0003

3. When the processing of the services is completed, click OK in the Backup Exec Services dialog box.

To upgrade the plug-in

1. Run the Backup Exec Services Manager and stop all services (do not close the dialog box).

2. Remove the old plug-in and install the new plug-in.

3. Return to the Backup Exec Services Manager dialog box to restart all services.

4. Close the dialog box.

DD Boost for OpenStorage Administration Guide 27

Page 28: Data Domain Boost Admin Guide 759-0010-0003

Tuning Windows Media Servers for Performance

This procedures applies to NetBackup and Backup Exec.

Tune the Windows media servers1. Select Run from the Start menu and enter regedit in the text

box.

2. Go to HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\ Services\Tcpip\Parameters.

3. Right-click and select New. Enter the name Register-to-set and select DWORD REG.

4. Right click Register-to-set and select Modify.

5. Do one of the following:

a. Set the value of this parameter:

TcpTimedWaitDelay =10

GlobalMaxTcpWindowSize = 4000000

TcpWindowSize = 262144

Tcp1323Opts = 1

EnablePMTUDiscovery =1

SackOpts = 1

TcpMaxDupAcks = 2

b. Copy and paste this data into a file with a .reg extension

-------------------------

[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\ Tcpip\Parameters]

"TcpTimedWaitDelay"=dword:0000000a

"GlobalMaxTcpWindowSize"=dword:003D0900

"TcpWindowSize"=dword:00040000

28 Installing Data Domain Boost for OpenStorage

Page 29: Data Domain Boost Admin Guide 759-0010-0003

"Tcp1323Opts"=dword:00000001

"EnablePMTUDiscovery"=dword:00000001

"SackOpts"=dword:00000001

"TcpMaxDupAcks"=dword:00000002

------------------------------

6. Double-click the reg file, or import it from regedit.

7. You must reboot Windows for the settings to take effect.

Note: To address Windows 2003 SP2 network performance issues on 32-bit Windows Servers 2003, search the Microsoft Support knowledge base for related information.

Uninstalling the Windows Plug-inThis procedures applies to NetBackup and Backup Exec.

Uninstall the Windows plug-in1. Stop the backup application’s services.

2. Do one of the following:

a. Uninstall the Data Domain OpenStorage plug-in via Window’s Control Panel uninstall/remove program feature (as you would uninstall a typical Windows program).

b. Double-click libstspiDataDomainUninstall.exe, which was installed in the same directory as the plug-in. Click Uninstall. After the uninstall, click Show details to view which files were removed.

DD Boost for OpenStorage Administration Guide 29

Page 30: Data Domain Boost Admin Guide 759-0010-0003

30 Installing Data Domain Boost for OpenStorage

Page 31: Data Domain Boost Admin Guide 759-0010-0003

3 Data Domain Boost Features

These DD Boost features apply to NetBackup and Backup Exec:

• Distributed segment processing on page 31

• Advanced Load Balancing and Link Failover on page 35

• Low-Bandwidth Optimization Option on page 39

• Encrypted Optimized Duplication on page 38

For instructions on how to configure these features, see 4 Data Domain Boost for OpenStorage Configuration.

Distributed segment processingDistributed segment processing distributes parts of the deduplication process to the OST plug-in, which avoids sending duplicate data to the Data Domain system configured as a storage server. The option to distribute the processing can be either enabled or disabled on a Data Domain system. The OST plug-in negotiates with the Data Domain system for the current setting of the option and behaves appropriately. Therefore, the OST plug-in offers two modes of operation for sending backup data to a Data Domain system: one with distributed segment processing option enabled and the other with the distributed segment processing option disabled.

DD Boost for OpenStorage Administration Guide 31

Page 32: Data Domain Boost Admin Guide 759-0010-0003

Figure 3-1: High-level Data Flow with distribute segment processing disabled

Distributed segment processing disabled

In this mode the OST plug-in sends the data directly to the Data Domain system over the LAN. The Data Domain system then segments, deduplicates, and compresses the data before it is written to the disk. A high-level data flow for in this scenario for a single-system Data Domain system with distributed segment processing disabled is shown in Figure 3-1. The OST plug-in runs on the media server.

Distributed segment processing enabled

In this mode, the deduplication process is distributed between the OST plug-in and the Data Domain system. The data flow for this mode is show in Figure 3-2.

Parts of the deduplication process are run on the OST plug-in so that only unique data is sent to data to a Data Domain system over LAN. The OST plug-in segments, computes IDs for the segments, checks with the Data Domain system for duplicate segments, compresses unique segments that are not found on the Data Domain system, and sends the compressed data to Data Domain system. The Data Domain system then stores unique data on disk.

32 Data Domain Boost Features

Page 33: Data Domain Boost Admin Guide 759-0010-0003

A high-level data flow for in this scenario for a single-system Data Domain system is shown in Figure 3-2. The OST plug-in runs on the media server.

Figure 3-2: High-level Data Flow with distributed segment processing enabled

The OST plug-in’s handling of data is transparent to the backup application, and the plug-in does not store any data on the media server.

For Data Domain Global Deduplication Array with two controllers, the data flow is as shown in Figure 3-3. The incoming data for a backup file is distributed between the two controllers based on a mapping maintained by the Data Domain controller designated as master.

Note: See the Data Domain Global Deduplication Administration Guide for more details on configuring a Global Deduplication System.

The OST plug-in sends chunks directly to the corresponding Data Domain controller based on the mapping by breaking it up into smaller segments and sending only the segments that are not stored on the Data Domain system.

DD Boost for OpenStorage Administration Guide 33

Page 34: Data Domain Boost Admin Guide 759-0010-0003

Figure 3-3: High-level Data Flow for a Global Deduplication System with distributed segment processing enabled

Note: The OST plug-in negotiates the local compression algorithm with the Data Domain system. The default local compression configured on a Data Domain system is lz.

Distributed segment processing provides the following benefits:

• Potentially higher throughput versus sending all of the data over the LAN to the Data Domain system because the OST plug-in sends only unique data to a Data Domain System. The throughput improvements depend on the redundant nature of the data being backed up, the overall workload on the media server, and the capability of the media server. In general, greater throughput is attained with higher redundancy and greater media server workload and media server capability.

• Allows utilizing existing 1 GbE infrastructure to achieve higher throughput than is physically possible over 1 GbE links. The network bandwidth requirements are significantly reduced

34 Data Domain Boost Features

Page 35: Data Domain Boost Admin Guide 759-0010-0003

since only the unique data is sent over the LAN to the Data Domain systems.

• Failed backups can potentially go much faster. If a large backup fails in the middle or towards the end, when it is restarted by the backup application, the data already sent to the Data Domain system does not have to be resent. This results in faster completion of the backup on retry.

See the DD OS Administration Guide for more information about local compression and its configuration.

You manage distributed segment processing via the ddboost option commands. Data Domain recommends that you use distributed segment processing if your network connection is 1 Gb Ethernet. See Configuring distributed segment processing on page 42.

Advanced Load Balancing and Link FailoverNetBackup and Backup Exec allow only one IP address per storage server. For Data Domain systems that require multiple 1 GbE links to obtain full system performance, it is necessary to set up multiple storage servers on the Data Domain systems (one per interface) and target the backup policies to different storage servers to spread the load on the interfaces.

The Advanced Load Balancing and Link Failover feature allows for combining multiple Ethernet links into a group. Only one of the interfaces on the Data Domain system is registered with the backup application. The OST plug-in negotiates with the Data Domain system on the interface registered with the backup application to obtain an interface to send the data. The load balancing provides higher physical throughput to the Data Domain system compared to configuring the interfaces into a virtual interface using Ethernet level aggregation.

The Data Domain system load balances the connections coming in from multiple media servers on all the interfaces in the group. The load balancing is transparent to the backup application. Because Advanced Load Balancing and Link Failover works at the DD Boost software layer, it is seamless to the underlying network connectivity and supports both physical and virtual interfaces.

DD Boost for OpenStorage Administration Guide 35

Page 36: Data Domain Boost Admin Guide 759-0010-0003

The data transfer is load balanced based on the number of connections outstanding on the interfaces. Only connections for backup and restore jobs are load balanced.

Notes:

The optimized-duplication connection between the Data Domain systems is not part of the load balancing. A single IP address is used for the target Data Domain system.

It is recommended that you exclude one interface from the ifgroup and reserve it for the optimized duplication path between the source and target Data Domain systems.

Figure 3-4 shows an example high-level configuration diagram. The interface marked in red is registered with the backup application.

Figure 3-4: Example Advanced Load Balancing and Link Failover Configuration Diagram

The Advanced Load Balancing and Link Failover feature can be used in conjunction with other network layer aggregation and failover technologies. The sample configuration in Figure 3-4 shows one such possibility. The links connecting the media servers and the switch that connects to Data Domain system are put in an aggregated failover mode. This configuration provides network failover functionality from end-to-end in the configuration. Any of

36 Data Domain Boost Features

Page 37: Data Domain Boost Admin Guide 759-0010-0003

the available aggregation technologies can be used between the media server and the switch.

The Advanced Load Balancing and Link Failover functionality also works in conjunction with other network layer functionality on the Data Domain systems, including VLAN tagging and IP aliasing. This functionality allows additional flexibility in segregating traffic into multiple virtual networks, all of which run over the same physical links on the Data Domain system.

Note: See the DD OS 5.0 Administration Guide for more information about how to configure VLAN tagging and IP aliasing on a Data Domain system.

Benefits of Advanced Load Balancing and Link Failover are as follows:

• Eliminates the need to register multiple storage servers (one for each interface) with the backup application, which can potentially simplify installation management.

• If one of the interfaces in the group goes down while the Data Domain system is still operational, the subsequent incoming backup jobs are routed to the available interfaces.

• The backup and restore jobs are automatically load balanced on multiple interfaces in the group, which can potentially result in higher utilization of the links.

• All in-flight jobs to the failed interface transparently are failed over to healthy operational links. From the point of view of the backup application (NetBackup or Backup Exec), the jobs continue uninterrupted.

For more information, see Configuring Advanced Load Balancing and Link Failover on page 43.

Configuration Restrictions• The interfaces can be added only to the group using an IP

address.

• Even though the Advanced Load Balancing and Link Failover feature works with both 1GbE interfaces and 10 GbE interfaces

DD Boost for OpenStorage Administration Guide 37

Page 38: Data Domain Boost Admin Guide 759-0010-0003

in a group, it is not a recommended setup. It is recommended to have like interfaces (in terms of link speed) in a group.

• Since only one interface group is supported on the Data Domain system, for connecting more than one media server, a switch is needed in the middle.

• The feature is not supported on Global Deduplication Arrays.

Encrypted Optimized DuplicationThe media servers (NetBackup or Backup Exec) set up optimized duplication jobs between two Data Domain systems after authenticating them using the pre-configured DD Boost user name and password. When an optimized job is set up by the media servers, if encrypted optimized duplication is enabled, the source and destination Data Domain systems encrypt the session between the two Data Domain systems using Secure Sockets Layer (SSL), so all image data and metadata is sent encrypted over WAN.

Enabling this option on Data Domain system is transparent to the backup applications (NetBackup and Backup Exec). When the backup application requests Data Domain system to perform an optimized duplication job, the source and destination systems negotiate automatically to perform encryption without knowledge of the requesting backup application. Encrypted optimized duplication uses the ADH-AES256-SHA cipher suite. There is no ability to configure a different suite in DD OS 5.0.

Encrypted optimized duplication is available to Data Domain systems with an installed Replicator license. The option is enabled on a per Data Domain system basis and applies to all optimized duplication jobs on that system. Both the source and the destination Data Domain systems that are participating in optimized duplication jobs must have this option enabled for it to take effect.

Encrypted optimized duplication can be used in conjunction with the encryption of data-at-rest feature available on DD OS with the optional Encryption license. When encrypted optimized duplication is used with the encryption of data-at-rest feature, the encrypted backup image data is encrypted again using SSL for sending over WAN.

38 Data Domain Boost Features

Page 39: Data Domain Boost Admin Guide 759-0010-0003

Notes:

Both the source and the destination Data Domain systems must be running DD OS 5.0 or later to use this feature.

Enabling this feature does not require restarting the file system on a Data Domain system.

The low-bandwidth optimization option and the encryption can be used in conjunction with each other.

For more information, see Enabling Encrypted Optimized Duplication on page 45 and the discussion of this topic in the DD OS 5.0 Administration Guide.

Low-Bandwidth Optimization OptionThe low-bandwidth Replicator option reduces the WAN bandwidth utilization. It is useful if optimized duplication is being performed over a low-bandwidth network (WAN) link. This feature provides additional compression during data transfer and is recommended only for optimized duplication jobs that occur over WAN links that have fewer than 6 Mb/s of available bandwidth.

The low-bandwidth optimization option is available to Data Domains systems with an installed Replicator license. The option is enabled on a per Data Domain system basis and applies to all optimized duplication jobs on that system.

Enabling this option on Data Domain system is transparent to the backup application. When the backup application requests a Data Domain system to perform an optimized duplication job, the source and destination systems automatically perform the additional compression without involvement of the requesting backup application.

All Data Domain systems that participate in optimized duplication jobs must have this option enabled for it to take effect.

For more information, see Enabling Low-Bandwidth Optimization on page 44, and the discussion of this topic in the DD OS 5.0 Administration Guide.

DD Boost for OpenStorage Administration Guide 39

Page 40: Data Domain Boost Admin Guide 759-0010-0003

40 Data Domain Boost Features

Page 41: Data Domain Boost Admin Guide 759-0010-0003

4 Data Domain Boost for OpenStorage Configuration

This chapter covers the following topics:

• Configuring the Data Domain System on page 41

• Creating Storage Units on page 42

• Configuring distributed segment processing on page 42

• Configuring Advanced Load Balancing and Link Failover on page 43

• Enabling Low-Bandwidth Optimization on page 44

• Registering Each Data Domain System on page 47

• Enabling Encrypted Optimized Duplication on page 45

• Configuring a Media Server on page 46

• NetBackup Configuration on page 46

• Backup Exec Configuration on page 62

Configuring the Data Domain SystemYou need to create one or more storage units for each Data Domain system enabled for OpenStorage in a NetBackup or Backup Exec installation. In a NetBackup system, a storage unit corresponds to disk pools on the media server whereas in a Backup Exec system, it corresponds to a tape repository.

Note: The following procedures for configuring a Data Domain system apply to NetBackup and Backup Exec.

DD Boost for OpenStorage Administration Guide 41

Page 42: Data Domain Boost Admin Guide 759-0010-0003

Creating Storage Units

Create storage units

1. On the Data Domain system, enter:

# ddboost storage-unit create storage-unit_name

Each storage unit name must be unique.

2. Repeat the above step for each Boost-enabled Data Domain system.

Configuring distributed segment processingThe distributed segment processing option is configured on the Data Domain system and applies to all the media servers and the OST plug-ins installed on them. If distributed segment processing is disabled on the Data Domain system, then the data flow from the media servers is as shown in Figure 3-1 on page 32. If distributed segment processing is enabled, then the data flows as shown in Figure 3-2 on page 33 for single system Data Domain systems and Figure 3-3 on page 34 for Global Deduplication Array systems.

The option can be configured using the following command:

# ddboost option set distributed-segment-processing {enabled | disabled}

Note: Enabling or disabling the distributed segment processing option does not require a restart of the Data Domain file system.

Distributed segment processing is supported with OST plug-in 2.2 or later communicating with a Data Domain system that is running DD OS 4.8 or later.

Distributed segment processing is enabled by default on a system initially installed with DD OS 4.8. If a system is upgraded from DD OS 4.6.x or 4.7.x to DD OS 4.8, and the DD Boost license is installed at the time of the upgrade, distributed segment processing is not automatically enabled.

Distributed segment processing is enabled by default on Global Deduplication Array configurations and cannot be disabled.

42 Data Domain Boost for OpenStorage Configuration

Page 43: Data Domain Boost Admin Guide 759-0010-0003

Configuring Advanced Load Balancing and Link Failover

Steps for configuring an interface group on the Data Domain system by adding four existing interfaces to the group, and registering the Data Domain with the backup application are described below.

Configure Advanced Load Balancing and Link Failover

1. Add the interfaces into the group:

# ddboost ifgroup add interface 192.168.1.1

# ddboost ifgroup add interface 192.168.1.2

# ddboost ifgroup add interface 192.168.1.3

# ddboost ifgroup add interface 192.168.1.4

Note: Only one default interface group can be created in DD OS 4.8, 4.9, or 5.0 releases, and this group cannot be named.

2. Select one of the interfaces on the Data Domain system to register with the backup application. It is recommended that you create one failover aggregated interface and register that interface with the backup application.

Note: It is not mandatory to have one of the interfaces in the ifgroup registered with the backup application. An interface that is not part of the ifgroup can also be used to register with the backup application.

Data Domain recommends that the interface be registered with a resolvable name using DNS or any other name resolution mechanism. Using NetBackup and assuming that 192.168.1.1 is named dd22.abc.com, execute the following command on the media server:

nbdevconfig -creatests -st 9 -stype DataDomain -storage_server dd22.abc.com -media_server load64

Note: The interface registered with the backup application is used by the backup application and the OST plug-in to communicate

DD Boost for OpenStorage Administration Guide 43

Page 44: Data Domain Boost Admin Guide 759-0010-0003

with the Data Domain system. If this interface is not available, then no backups to that Data Domain system are possible.

3. Enable the feature on the Data Domain system:

# ddboost ifgroup enable

4. Verify the configuration Data Domain system:

# ddboost ifgroup show config

Interface

-------------

192.168.1.1

192.168.1.2

192.168.1.3

192.168.1.4

-------------

Note: You manage Advanced Load Balancing and Link Failover via the ddboost ifgroup commands.

After the interface group is setup, you can add or delete interfaces from the group. See Modifying an Interface Group on page 101.

Enabling Low-Bandwidth Optimization To enable the low-bandwidth option, enter:

# ddboost file-replication option set low-bw-optim enabled

Low bandwidth optimization enabled for optimized duplication.

Note: Enabling or disabling the low-bandwidth option does not require a restart of the Data Domain file system. After enabling it, however, you need to run a full cleaning cycle on the Data Domain system for it to be effective.

See ddboost file-replication on page 85 for more details on how to monitor and manage low-bandwidth optimization.

No configuration changes are necessary on the media server as this feature is transparent to the backup applications. Turning on this

44 Data Domain Boost for OpenStorage Configuration

Page 45: Data Domain Boost Admin Guide 759-0010-0003

feature takes additional resources (CPU and memory) on the Data Domain system, so it is recommended that this option be used only when optimized duplication is being done over low-bandwidth networks with less than 6 Mbps aggregate bandwidth.

Notes:

For more information on this feature, see the DD OS 5.0 Administration Guide.

The low-bandwidth option for optimized duplication is supported only for standalone Data Domain systems.

Enabling Encrypted Optimized DuplicationTo enable the low-bandwidth option, enter:

# ddboost file-replication option set encryption enabled

The output indicates that the encryption you requested was enabled.

See the ddboost file-replication on page 85 for more details on how to monitor and manage encryption option for optimized duplication.

No configuration changes are necessary on the media server as this feature is transparent to the backup applications NetBackup and Backup Exec. Turning on this feature takes additional resources (CPU and memory) on Data Domain system.

Notes:

Enabling or disabling the encrypted optimized duplication option does not require a restart of the Data Domain file system.

For more information on this feature, see discussion of this topic in the DD OS 5.0 Administration Guide.

DD Boost for OpenStorage Administration Guide 45

Page 46: Data Domain Boost Admin Guide 759-0010-0003

Configuring a Media ServerMedia server configuration depends on the backup application being used. See the appropriate configuration section.

• NetBackup Configuration on page 46

• Backup Exec Configuration on page 62

NetBackup ConfigurationNote: The examples in this chapter assume the following configuration:

• A media server with the name load64 that runs NBU 6.5 or 7.0.

• DD Boost-enabled Data Domain systems named dd22 and dd23.

Media server configuration consists of the following procedures:

• registering each Data Domain system;

• adding credentials for each media server that is to communicate with a Data Domain system;

• creating disk pools;

• creating storage units, which are collections of disk pools; and

• setting backup policies.

Follow these recommended practices:

• To avoid the need for frequent DNS lookups, add every media server host/IP address to the Data Domain system using the net hosts add ipaddr {host | "alias host"}... command.

Note: DNS reverse lookup has been added for every media server accessing the Data Domain system as of DD OS 4.6.3.

• To avoid DNS lookup for every job, also add the Data Domain system IP address into the media server’s /etc/hosts file.

Note: Commands that run on the command line can be entered on either the master or the media server. If you run commands from

46 Data Domain Boost for OpenStorage Configuration

Page 47: Data Domain Boost Admin Guide 759-0010-0003

the master server, use the -media_server option to tell NBU where to direct the operation that queries the plug-in about the storage server’s properties.

Concurrent Connection Limit

With NetBackup and Backup Exec, the default number of concurrent connections (jobs) from a single media server is 64. To increase this number, contact your EMC technical consultant.

Registering Each Data Domain System

Register the Data Domain systems

1. On the media server, start the backup application’s services. See NetBackup Services on page 23.

2. Verify that the plug-in is detected by the backup application by entering:

# bpstsinfo -pi

The output shows the vendor version, which is the plug-in version, and the build version, which is the OST plug-in version.

3. Register a Data Domain system by entering:

# nbdevconfig -creatests -stype DataDomain -storage_server dd22 -media_server load64

In this case, the storage_server can be either an IP address or a hostname, such as dd22.

Note: NetBackup 7 allows the credentials to be configured from within NetBackup as well. See the NetBackup documentation for more information.

4. Repeat the above procedure for each DD Boost-enabled Data Domain system.

DD Boost for OpenStorage Administration Guide 47

Page 48: Data Domain Boost Admin Guide 759-0010-0003

Adding Credentials

Add credentials

1. On a media server that is to communicate with a Data Domain system, enter:

# tpconfig -add -storage_server dd22 -stype DataDomain -sts_user_id username -password password

Note: NetBackup 7 allows the credentials to also be configured from within NetBackup. See the NetBackup documentation for more information.

2. Repeat the above step for each media server that is to communicate with a specific Data Domain system.

After you add the credentials, the backup application does the following:

• Saves the credentials so the media server can log into the Data Domain system.

• Configures the media server as a data mover that can transfer data between the primary storage (the backup application’s client) and the storage server (the Data Domain system). The backup application maintains an access path between the media server and the storage server.

Creating Disk Pools

Disk pools are collections of disk volumes that the backup application administers as single entities. Disk pools correspond to storage units.

Note: Each disk pool requires a unique name.

The backup application provides a command line interface (CLI) and a graphical user interface (GUI). You can use either to create disk pools.

48 Data Domain Boost for OpenStorage Configuration

Page 49: Data Domain Boost Admin Guide 759-0010-0003

Create a disk pool using the CLI

1. The backup application’s Remote Manager and Monitor Service (nbrmms) must be running. To restart it, enter:

# nbrmms

2. Obtain the identity of the storage unit on the Data Domain system (dd22) by entering:

# nbdevconfig -previewdv -storage_server dd22 -stype DataDomain > /tmp/dvlist

3. Create a disk pool using the information obtained from the previous command by entering:

# nbdevconfig -createdp -dp dd22_storage-unit1_dp -stype DataDomain -storage_servers dd22 -dvlist /tmp/dvlist

The disk pool name must be unique.

Output similar to the following is displayed:

Disk pool dd22_storage-unit1_dp has been successfully created with 1 volume.

Create a disk pool using the GUI

1. Open the NetBackup Administration Console’s Devices window.

DD Boost for OpenStorage Administration Guide 49

Page 50: Data Domain Boost Admin Guide 759-0010-0003

2. In left pane of this window, expand the Media and Device Management node. Expand the Devices node. Right-click Disk Pools. Select New Disk Pool from the menu.

3. The Disk Pool Configuration Wizard is displayed. Select the Data Domain system from the Storage server list, and click Next.

50 Data Domain Boost for OpenStorage Configuration

Page 51: Data Domain Boost Admin Guide 759-0010-0003

4. Select (check) the storage unit in the Volume Name list, and click Next.

5. In the Disk Pool Properties window, enter a unique name for the disk pool in the Disk Pool name text box. Click Next.

DD Boost for OpenStorage Administration Guide 51

Page 52: Data Domain Boost Admin Guide 759-0010-0003

6. After creating the disk pool, you are given the option of continuing to use the GUI to create a storage unit, which is a collection of disk pools. For instructions, see Creating Storage Units on page 52.

Creating Storage Units

A storage unit contains a disk pool. Multiple storage units can be grouped together into a Storage Unit Group. You can create storage units using either the CLI or the GUI.

Note: Each storage unit requires a unique name.

Create storage units using the CLI

Enter a command similar to the following:

# bpstuadd -label dd22_storage-unit1_su -dp dd22_storage-unit1_dp -host load64a -M load64a

Note: There is no output from this command.

Create storage units using the GUI

1. Open the NetBackup Administration Console’s Storage window.

52 Data Domain Boost for OpenStorage Configuration

Page 53: Data Domain Boost Admin Guide 759-0010-0003

2. In the left pane, expand the NetBackup Management node. Under the Storage node, right-click Storage Units, and select New Storage Unit from the menu.

3. In the New Storage Unit dialog box, enter a unique name for the new storage unit.

DD Boost for OpenStorage Administration Guide 53

Page 54: Data Domain Boost Admin Guide 759-0010-0003

4. For the Storage unit type, select Disk from the list.

5. For the Disk type, select OpenStorage (DataDomain) from the list.

6. For the Disk Pool, select the desired disk pool from the list.

7. Select the media servers that can access this storage unit.

• If any media server is allowed to access the storage unit, select Use any available media server.

• If a storage unit needs to be visible to a select set of media servers, select (check) the name of each in the Media Servers list.

Note: If a server does not appear in the list, verify that its OST plug-in has been installed and that its login credentials have been configured.

8. Click OK.

54 Data Domain Boost for OpenStorage Configuration

Page 55: Data Domain Boost Admin Guide 759-0010-0003

Creating a Backup Policy

For instructions on creating a backup policy, see the Symantec NetBackup Administration Guide.

Configuring Buffers

You can set the number and size of various buffers, but cannot change their size limits. The location for these files depends on your operating system.

• The UNIX file location is /usr/openv/netbackup.

• The Windows file location is install_path\netbackup\db\config.

For best performance, set the SIZE_DATA_BUFFERS and SIZE_DATA_BUFFERS_DISK to 262144.

Create buffer files

To set the number and size of buffers, create the following files, as appropriate for your operating system.

NET_BUFFER_SZ

• Description: TCP/IP socket buffer size

• Media: N/A

• Default on UNIX: 32,032

• Default on Windows: 32,032

NUMBER_DATA_BUFFERS

Note: The number must be a power of two.

• Description: Number of shared data buffers.

• Media: Tape

• Default on UNIX: 8/4 (Non-multiplexed/multiplexed.)

• Default on Windows: 16/8 (Non-multiplexed/multiplexed.)

DD Boost for OpenStorage Administration Guide 55

Page 56: Data Domain Boost Admin Guide 759-0010-0003

NUMBER_DATA_BUFFERS_RESTORE

• Description: Number of shared data buffers.

• Media: Tape

• Default on UNIX: 8/12 (Non-multiplexed/multiplexed.)

• Default on Windows: 16/12 (Non-multiplexed/multiplexed.)

NUMBER_DATA_BUFFERS_DISK

Note: The number must be a power of two.

• Description: Number of shared data buffers.

• Media: Disk

• Default on UNIX: 8/4 (Non-multiplexed/multiplexed.)

• Default on Windows: 16/8 (Non-multiplexed/multiplexed.)

SIZE_DATA_BUFFERS

Note: The size must be a multiple of 32 KB. The default used when this file does not exist is 32 KB. The maximum value supported by the Data Domain plug-in is 1 MB.

The default value when the file exists, and the recommended value for best performance is 256 KB.

• Description: Size of shared data buffers.

• Media: Tape

• Default on UNIX: 64 KB

• Default on Windows: 64 KB

SIZE_DATA_BUFFERS_DISK

Note: The size must be a multiple of 32 KB.The default used when this file does not exist is 32 KB. The maximum value supported by the Data Domain plug-in is 1 MB.

56 Data Domain Boost for OpenStorage Configuration

Page 57: Data Domain Boost Admin Guide 759-0010-0003

The default value when the file exists, and the recommended value for best performance is 256 KB.

• Description: Size of shared data buffers.

• Media: Disk

• Default on UNIX: 256 KB

• Default on Windows: 256 KB

SIZE_DATA_BUFFERS_NDMP

• Description: Buffer size for NDMP backups.

• Media: N/A

• Default on UNIX: 63 KB

• Default on Windows: 63 KB

Configuring Optimized Duplication

The OST plug-in enables a NetBackup media server to specify a duplication process and delegate its execution to the Data Domain system. This sharing has the following advantages:

• The backup application system retains control of creating and duplicating backup files and keeps track of all copies in its catalog, which ensures easy and efficient recovery.

• Optimized duplication removes the media server from the data path in creating duplicate copies of backup images, which reduces the load on the backup application system and frees it for other work.

• The Data Domain system uses Wide Area Network (WAN) efficient replication process for deduplicated data. The process is optimized for WANs, which reduces the overall load on the WAN bandwidth required for creating a duplicate copy.

• Data Domain Replicator software features, such as Low-Bandwidth Optimization Option, can be used transparent to the backup application to reduce further the data sent over WAN links that are fewer than 6 Mb/s.

• Data Domain Replicator software features, such as Encrypted Optimized Duplication, can be used transparent to the backup

DD Boost for OpenStorage Administration Guide 57

Page 58: Data Domain Boost Admin Guide 759-0010-0003

applications. This feature allows all data sent over the WAN for the purpose of creating duplicate copies to be encrypted, which provides higher security.

Notes:

Prior to NetBackup version 6.5.4, when an optimized duplication job failed, duplication job retry attempted to use conventional duplication. This resulted in sending the fully inflated complete backup file from the source OpenStorage storage unit through one, or possibly two, NetBackup media servers to the destination OpenStorage storage unit.

NetBackup version 6.5.4, by default, does not retry a failed optimized duplication job unless it was initiated by means of a Storage Lifecycle Policy. When retried via a Storage Lifecycle Policy, the job attempts to use optimized duplication only. The default behavior can be overridden by configuring NetBackup to retry with conventional duplication. See the Veritas NetBackup™ Shared Storage Guide UNIX, Windows, Linux Release 6.5.4 document for detailed information.

Data Domain recommends that you add the destination Data Domain system’s IP address to the source Data Domain system using the net hosts add ipaddr {host | "alias host"}... command.

Note: All media servers, source and destination, must have permission to access both Data Domain systems. It is recommended that you add all of the media servers that need to access a Data Domain system to it using the net hosts add command.

Using Storage Lifecycle Policies to Automate Optimized Duplication

A storage lifecycle policy consists of a list of destinations for backup files and a retention period for each file. A lifecycle process creates, retains, and finally expires the files. Using storage lifecycle policies allows you to specify different retention periods for the initial backup and for the duplicate copies. For example, you might specify one retention period for the original local backup and another for a duplicate at a disaster recovery site.

58 Data Domain Boost for OpenStorage Configuration

Page 59: Data Domain Boost Admin Guide 759-0010-0003

Notes:

If there is a preferred link or IP address for sending the optimized duplication data between two Data Domain storage servers, use that link or address when creating the destination storage server.

Should you ever want to start optimized duplication manually, use the NBU CLI command bpduplicate, which is described in the Symantec NetBackup documentation.

Create a storage lifecycle policy

This example creates a lifecycle policy that backs up to a DD Boost-enabled Data Domain system and then creates a duplicate copy on another DD Boost-enabled Data Domain system. There are two storage destinations. The first serves as backup to the first DD Boost-enabled Data Domain system. The second storage destination is used for duplication to the second DD Boost-enabled Data Domain system.

1. Open the NetBackup Administration Console’s Storage window.

2. In left pane of the window, expand the NetBackup Management node and then the Storage node. Right-click Storage Lifecycle Policies. Select New Storage Lifecycle Policy from the menu.

DD Boost for OpenStorage Administration Guide 59

Page 60: Data Domain Boost Admin Guide 759-0010-0003

3. In the New Storage Lifecycle Policy dialog box, enter a lifecycle policy name in the Storage lifecycle policy name text box.

4. Click the Add button to add a new storage destination to the list.

5. In the New Destination dialog box, select either Backup or Duplication, depending on how the policy is to be used. In this example, select Backup.

6. Select the storage unit (dd22_storage-unit1_su) from the list.

7. Select one of the retention types:

• Fixed

Fixed retention means that the backup is retained for a specific period of time. Afterwards, NetBackup deletes information about the expired backup, and the files in the

60 Data Domain Boost for OpenStorage Configuration

Page 61: Data Domain Boost Admin Guide 759-0010-0003

backup become unavailable to restore operations. Fixed retention enables you to use different retention periods for backup copies on local and remote Data Domain systems. For example, you might retain backups at the local Data Domain system for one week and the copies at a remote disaster recovery Data Domain system for four weeks.

• Staged capacity managed

This type means that the Data Domain system serves as a staging device before it is duplicated to a final destination. The Data Domain system must be configured to use disk staging.

Note: Disk staging is supported in DD OS 4.6 and later.

• Expire after duplication

This type applies only to backup destinations, not to duplication destinations. As soon as NetBackup duplicates the backup, NetBackup deletes information about the backup and the files in the backup become unavailable to restore operation.

8. Click OK in the New Destination dialog box.

9. Return to the New Storage Lifestyle Policy dialog box.

10. Click the Add button.

11. In the New Destination dialog box, select a different storage unit for Duplication. Click OK, which adds it to the list in the New Storage Lifecycle Policy dialog box.

12. Click OK.

Note: NetBackup 6.5.4 introduced Hierarchical Duplication, which allows creation of up to ten duplicate copies using Storage Lifecycle Policies. Policies can be defined such that the third copy can be sourced from the second copy, which is the first duplicate copy. See the NetBackup documentation for more information.

DD Boost for OpenStorage Administration Guide 61

Page 62: Data Domain Boost Admin Guide 759-0010-0003

Backup Exec Configuration When you launch the Backup Exec application, its Home page is displayed. This page guides you through the configuration procedures. It provides links to Backup Exec technical support and documentation, as well as an alerts and job history summaries.

Note: For information on setting up, scheduling, and monitoring jobs, see the Symantec Backup Exec 2010 Administrator’s Guide.

Figure 4-1: Backup Exec Home Page

Complete these Getting Started steps (as shown in the upper-left of the home page):

1. Create a logon account.

2. Configure devices.

Notes:

• Click the icon to the left of the task to launch a wizard or assistant that guides you through the configuration step.

• A green check to the left of a task indicates that a task has been completed.

62 Data Domain Boost for OpenStorage Configuration

Page 63: Data Domain Boost Admin Guide 759-0010-0003

Creating a Logon Account

Follow these steps to create a logon account.

Create a logon account

1. Double-click the icon to the left of 1) Create Logon Accounts in the Getting Started panel of the Home page. The Logon Account Wizard Welcome dialog box is displayed. Click Next.

2. In the Set Up a Logon Account dialog box, select Add a new logon account, and click Next.

3. In the Enter Logon Account Credentials dialog box, enter the user name and password set for DD Boost. Click Next.

4. In the Logon Account Name dialog box, type an account name that describes this logon account. Click Next.

5. In the Type of Logon Account dialog box, make the account available to all Backup Exec users. Click Next.

6. In the Default Logon Account dialog box, select No. The Data Domain system account is usually not the Backup Exec system logon. Click Next.

7. Verify your account settings as shown in the Logon Account Summary dialog box. Click Back to edit prior selections. If the account information is correct, click Next.

8. The Completing the Logon Account Wizard dialog box is displayed. Click Finish.

Configuring Devices

Follow these steps to configure devices.

Configure devices

1. Create a storage unit on the Data Domain system. See Creating Storage Units on page 42.

2. From the Backup Exec Home page, select Configure Devices from the Tools menu. Select Add OpenStorage from the menu.

DD Boost for OpenStorage Administration Guide 63

Page 64: Data Domain Boost Admin Guide 759-0010-0003

3. Configure the AddOpenStorage Device dialog box’s General tab as follows:

• Name: Enter the name of the Data Domain system.

• Server: Enter the Data Domain host name.

• Select the logon account name previously created.

• Select DataDomain as the server type.

• Storage unit: Select storage unit.

• Concurrent Operations: Specify the number of concurrent operations for the device.

The total number of concurrent connections (jobs) from a single media server OST plug-in to all associated OpenStorage storage units is 48. The concurrent operations limit for a single device can be determined as follows:

48 >= # OpenStorage storage units + ∑ concurrent operations for each storage unit

In the case of a single Data Domain system with a single storage unit, the concurrent operation count can be set as high as 47.

4. Click OK.

64 Data Domain Boost for OpenStorage Configuration

Page 65: Data Domain Boost Admin Guide 759-0010-0003

5. Configure the AddOpenStorage Device dialog box’s Advanced tab as follows:

• Accept the default values for Disk Space Management and Direct Access.

• Specify a Data stream chunk size from 64 KB to 256 KB. For best performance, 256 KB is recommended.

6. Click OK.

7. Click the Sharing tab.

A single Data Domain storage unit can be shared by multiple media servers when the shared media servers are associated with a single primary media server.

In the media servers list, select the primary media server, and click OK.

8. You must restart the Backup Exec services when a new Data Domain system is added. In the Restart Services dialog box, click Restart Now.

DD Boost for OpenStorage Administration Guide 65

Page 66: Data Domain Boost Admin Guide 759-0010-0003

After the device has been configured, the new storage unit is displayed in the Devices page (Figure 4-2).

Figure 4-2: Backup Exec Devices

Configuring Optimized Duplication

The ways to develop duplication jobs in Backup Exec are described in detail in the Symantec Backup Exec 2010 Administrator’s Guide. You can attach an associated duplicate job to any backup job, or duplicate a previous backup set.

The OST plug-in enables a media server to specify a duplication process and delegate its execution to the Data Domain system. This sharing has the following advantages:

• The backup application system retains control of creating and duplicating backup files and keeps track of all copies in its catalog, which ensures easy and efficient recovery.

• Optimized duplication removes the media server from having to create duplicates of backup files, which reduces the load on the backup application system and frees it for other work.

• The Data Domain system uses Wide Area Network (WAN) efficient replication process for deduplicated data. The process

66 Data Domain Boost for OpenStorage Configuration

Page 67: Data Domain Boost Admin Guide 759-0010-0003

is optimized for WANs, which reduces the overall load on the WAN bandwidth required for creating a duplicate copy.

• Data Domain Replicator software features, such as Low-Bandwidth Optimization Option, can be utilized transparent to the backup application for further reducing the data sent over WAN links that are less than 6 Mb/s.

• Data Domain Replicator software features, such as Encrypted Optimized Duplication, can be used transparent to the backup applications. This feature allows all data sent over the WAN for the purpose of creating duplicate copies to be encrypted, which provides higher security.

Data Domain recommends that you add the destination Data Domain system’s IP address to the source Data Domain system using the command:

net hosts add ipaddr {host | "alias host"}

Note: All media servers, source and destination, must have permission to access both Data Domain systems. It is recommended that you add all of the media servers that need to access a Data Domain system to it using the net hosts add command.

To duplicate an image from one system to another, the following conditions must be met:

• The Data stream chunk size for devices configured on both Data Domain systems between which optimized duplication is to take place must be set to the same value. It is recommended that this value be 256 KB as shown in the OpenStorage Device Properties dialog box.

DD Boost for OpenStorage Administration Guide 67

Page 68: Data Domain Boost Admin Guide 759-0010-0003

Figure 4-3: OpenStorage Device Properties (General Tab)

This value is set during storage unit creation when the media device representing the storage unit on the Data Domain system is added to Backup Exec.

• The Concurrent Operations count of the destination Data Domain system is greater than or equal to that of the source Data Domain system. See Figure 4-3.

68 Data Domain Boost for OpenStorage Configuration

Page 69: Data Domain Boost Admin Guide 759-0010-0003

Configuration Limitations for Optimized Duplication

1. Optimized Duplication is supported with Backup Exec 2010 R2 or higher.

2. Data Domain supports optimized duplication for images that have only one dataset. If multiple volumes or selections from multiple volumes (C:\Windows, D:, E:, etc.), or agents (SQL Server, SharePoint, etc.), or a combination are being backed up in one job, then the resulting backup image contains datasets for all the drives or the applications unless Symantec Backup Exec Hotfix 138226 is applied. This Hotfix can be applied only to Backup Exec 2010 R2.

With Hotfix 138226 applied, Backup Exec creates multiple images, one for each dataset in the backup job. In the above example that contains multiple volumes in a job, there would be three images produced—one for C:\Windows, one for D: andone for E:. Optimized duplication of select individual images,or all three images, can then be carried out by Backup Exec.

Figure 4-4 show an example of the type of backup images that can be duplicated using optimized duplication. OST-00000129-446E7A3EBD620BBE can be duplicated using optimized duplication, whereas OST-00000128-446E7A3EBD620BBE cannot be duplicated because it contains data from multiple sources.

DD Boost for OpenStorage Administration Guide 69

Page 70: Data Domain Boost Admin Guide 759-0010-0003

Figure 4-4: New Duplicate Backup Set Job

70 Data Domain Boost for OpenStorage Configuration

Page 71: Data Domain Boost Admin Guide 759-0010-0003

Add a duplication job to an existing jobThese instructions assume that you have developed a backup job that is running (or scheduled to be run) in order to generate a backup set on the source Data Domain system (media device ddr5).

1. Open the Job Setup panel.

2. In the left panel, select Backup Tasks > New job to duplicate backup sets.

3. In the New Job to Duplicate Backup Sets dialog box, select the Duplicate backup sets following a job option, and click OK.

4. In the Source > Job panel, select an available job that is running or scheduled to be run, pf86, as shown below.

DD Boost for OpenStorage Administration Guide 71

Page 72: Data Domain Boost Admin Guide 759-0010-0003

5. In the Destination > Device and Media panel, select the remote Data Domain system, in this case a device named ddr8 as shown below. Complete file options as required.

72 Data Domain Boost for OpenStorage Configuration

Page 73: Data Domain Boost Admin Guide 759-0010-0003

6. In the Settings > General panel, verify that the source Data Domain system is set properly, in this example a device named ddr5 as shown below.

The Job Monitor panel displays the status of the jobs as they are scheduled and run.

DD Boost for OpenStorage Administration Guide 73

Page 74: Data Domain Boost Admin Guide 759-0010-0003

The scheduled backup jog, pf86, and a scheduled duplicate backup job are shown below:

Each time the backup job runs, the duplicate job is run after it.

74 Data Domain Boost for OpenStorage Configuration

Page 75: Data Domain Boost Admin Guide 759-0010-0003

Figure 4-5: Job History

The Job History dialog box shown in Figure 4-5 contains job statistics and log events for each of the two jobs.

DD Boost for OpenStorage Administration Guide 75

Page 76: Data Domain Boost Admin Guide 759-0010-0003

Duplicate a previous jobPrerequisite: An existing backup job and at least one backup set saved on the source Data Domain system (media device named ddr5 in this example).

1. Open the Job Setup panel.

2. Select the New job to duplicate backup tasks in the left hand sub-panel:

3. In the New Job to Duplicate Backup Sets, select the Duplicate existing backup sets option, and click OK.

76 Data Domain Boost for OpenStorage Configuration

Page 77: Data Domain Boost Admin Guide 759-0010-0003

4. In the Source > Selections panel, select an available media set that has been created on media device ddr5.

5. In the Destination Device and Media panel, select the remote Data Domain system, in this case a device named ddr8. Complete file options as required.

DD Boost for OpenStorage Administration Guide 77

Page 78: Data Domain Boost Admin Guide 759-0010-0003

6. In the Settings > General panel, verify that the source Data Domain system is set properly, in this example a device named ddr5.

7. You can schedule this duplication for later, or click Run Now to start it.

The Job Monitor panel displays the status of the job as it runs.

78 Data Domain Boost for OpenStorage Configuration

Page 79: Data Domain Boost Admin Guide 759-0010-0003

Upon completion the job is moved to the Job History list.

The Job History contains job statistics and log events.

DD Boost for OpenStorage Administration Guide 79

Page 80: Data Domain Boost Admin Guide 759-0010-0003

80 Data Domain Boost for OpenStorage Configuration

Page 81: Data Domain Boost Admin Guide 759-0010-0003

5 Using the DD Boost Commands

This chapter describes the DD Boost commands that you use to manage the DD Boost feature on the Data Domain system.

Note: For information about configuring DD Boost using the graphical-user interface-based Enterprise Manager, see the DD OS 5.0 Administration Guide.

The ddboost command includes the following options.

destroy Delete all storage units and their contents from the Data Domain system.

Page 82

disable Disable DD Boost. Page 82

enable Enable DD Boost. Page 82

ifgroup For Advanced Load Balancing and Link Failover: Manage interface group (IP addresses) on a Data Domain private network that processes data transfer.

Page 83

file-replication

Set, reset, or show the status of the low- bandwidth optimization and/or encryption option for optimized duplication. Show or reset statistics, history, and performance.

Page 85

option Set, reset, or show the status of the distributed segment processing feature.

Page 91

reset Delete the DD Boost user and reset statistics. Clear all job connection counters shown in the output of the ddboost show connections command in the event that network connection is lost

Page 92

show Show the DD Boost connections, DD Boost histogram, or statistics.

Page 93

status Show whether DD Boost is enabled or disabled.

Page 96

DD Boost for OpenStorage Administration Guide 81

Page 82: Data Domain Boost Admin Guide 759-0010-0003

ddboost Command Options

enableddboost enable

Administrators use this command to enable DD Boost.

Whenever the user, user ID (UID), or group ID (GID) changes, the Data Domain system updates all files and storage units the next time that the ddboost enable command is issued.

destroyddboost destroy

Administrators use this command to delete all storage units and their contents from the Data Domain system. The command permanently removes all of the data (files) contained in the storage units.

You must also manually remove (expire) the corresponding catalog entries.

disableddboost disable

Administrators use this command to disable DD Boost for the Data Domain system.

storage-unit Create and delete a storage unit, or list the storage units and files in a storage unit.

Page 96

user-name Reset, set, or show DD Boost users. Page 97

82 Using the DD Boost Commands

Page 83: Data Domain Boost Admin Guide 759-0010-0003

ifgroup

Notes:

ifgroup is an interface group.

Advanced Load Balancing and Link Failover is not supported for a Global Deduplication Array.

ifgroup add interfaceddboost ifgroup add interface ipaddr

Administrators use this command to add an IP address to a private network that is to process data transfer. The IP address must be configured on the Data Domain system, and its interface enabled.

The command checks if the IP address is valid. If not, a message reports the IP address is invalid (either because it is not configured on the Data Domain system, or its interface is not enabled). Use the net show settings or net show config commands to view available IP addresses.

If the IP is valid, the message IP added to list is displayed. After adding an IP address as an interface, you need to enable Advanced Load Balancing and Link Failover using the ddboost ifgroup enable command.

Notes:

• If an interface (or a NIC that has multiple interfaces) fails, all the in-flight jobs to that interface transparently fail over to a healthy interface in the ifgroup. Any jobs that are started subsequent to the failure are routed to the healthy interfaces. You can add public or private IP addresses for data transfer connections.

• It is not recommended that you use 1 GigE and 10 GigE connections in the same interface group.

• You can add public or private IP addresses for data transfer connections.

DD Boost for OpenStorage Administration Guide 83

Page 84: Data Domain Boost Admin Guide 759-0010-0003

ifgroup del interfaceddboost ifgroup del interface ipaddr

Administrators use this command to remove a valid IP address added as an interface.

If you are attempting to delete the last IP address interface, you are informed that the ifgroup will be disabled and are given the option of terminating this command.

ifgroup disableddboost ifgroup disable

Administrators use this command to disable the Advanced Load Balancing and Link Failover option for new jobs. Currently running jobs are not affected and continue to run.

If DD Boost is disabled, the message disabled is displayed.

ifgroup enableddboost ifgroup enable

Administrators use this command to enable Advanced Load Balancing and Link Failover. At least one IP address must have already been added.

ifgroup show configifgroup show config

Use this command to show the IP addresses that have been added to the ifgroup.

84 Using the DD Boost Commands

Page 85: Data Domain Boost Admin Guide 759-0010-0003

ifgroup resetifgroup reset

Administrators use this command to remove the interfaces for Advanced Load Balancing and Link Failover and to disable the ifgroup. The ifgroup reset command is equivalent to issuing the ddboost ifgroup disable command followed by issuing multiple ddboost ifgroup del interface interface ipaddr commands.

ifgroup statusifgroup status

Use this command to show whether Link Aggregation is enabled or disabled.

file-replicationNote: The low-bandwidth optimization option is not supported in a Global Deduplication Array.

file-replication option resetddboost file-replication option reset {low-bw-optim | encryption}

Administrators can use this command to reset low-bandwidth optimization and/or encryption to its default value, which is disabled.

file-replication option set ddboost file-replication option set {encryption {enabled | disabled}|low-bw-optim {enabled | disabled}

This command must be entered on both Data Domain systems—the source and destination (target) systems. Only an administrator can set these two options.

DD Boost for OpenStorage Administration Guide 85

Page 86: Data Domain Boost Admin Guide 759-0010-0003

Low-bandwidth optimization, which is disabled by default, is designed for use on networks with less than 6 Mbps aggregate bandwidth. Do not use this option if maximum filesystem write performance is required.

After you enable low-bandwidth optimization on both systems, both systems must undergo a full cleaning cycle to prepare the existing data. Enter this CLI command on the source and destination systems:

# filesys clean start

The amount of time the cleaning cycle takes depends on the amount of data currently on the Data Domain system. Encryption must be enabled on both the source and destination systems.

file-replication option showddboost file-replication option show [low-bw-optim]| [encryption]

Use this command to show whether low-bandwidth optimization and/or encryption is enabled or disabled for optimized duplication.

file-replication reset statsddboost file-replication reset stats

Administrators can use this command to reset file-replication statistics when DD Boost is enabled.

file-replication show activeddboost file-replication show active

Use this command to show the status of a DD Boost file replication transfer to a destination Data Domain system.

The low-bandwidth optimization status output indicates either that it is enabled and running, or that it is enabled but there is a configuration mismatch.

86 Using the DD Boost Commands

Page 87: Data Domain Boost Admin Guide 759-0010-0003

file-replication show detailed-file-history

ddboost file-replication show detailed-file-history [duration duration{day | hr}]

This command shows the file-replication history over time. The output is organized by file; it is not cumulative data. You must specify a duration.

The data for each file name is organized by date, time, and direction (outbound or inbound). Values are given in KB for pre-compressed, post-filtered, post-low-bw-option, post-compressed, and network data. The last value is an error code; 0 indicates no error occurred. A sample line with a description of each column follows:

• Date: 2010/06/16

• Time: 07:48:22

• Direction: Outbound

• File name: /data/col1/x-ddp1/PEOST_00000001:0000000000:BEOST:4:0::

• Pre-compressed: 3,765,837

• Post-filtered: 30,802

• Post-low-bw-optim: 30,802

• Post-compressed: 17,423

• Network: 65,550

• Error code: 0

file-replication show detailed-history

ddboost file-replication show detailed-history [duration duration{day | hr}] [interval hr]

This command shows the file-replication history over time. A cumulative history is shown, as opposed to a view by file name. You must specify a duration.

Data is organized by date, time, and direction (outbound or inbound). Cumulative values are given in KB for pre-compressed,

DD Boost for OpenStorage Administration Guide 87

Page 88: Data Domain Boost Admin Guide 759-0010-0003

rrors

post-filtered, post-low-bw-option, post-compressed, and network data. The last value is an error code; 0 indicates no error occurred.

file-replication show historyddboost file-replication show history [duration duration{day | hr}] [interval hr]

Use this command to show the data transfer history between the source and destination (target) Data Domain systems. The following information is shown for inbound and outbound traffic for a given duration at a specified interval:

• amount of pre-compressed data in KB

• amount of post-compressed data in KB

• network transfer data in KB

• low-bandwidth optimization factor

• number of errors

file-replication show file-historyddboost file-replication show file-history [duration duration{day | hr}]

Use this command to show the data transfer history for inbound and outbound traffic on each file in Data Domain system’s backup directory for a given duration at a specified interval. The following is shown for inbound and outbound traffic by date and time:

• amount of pre-compressed data in KB

• amount of post-compressed data in KB

Example of Boost file-replication show history command output:

Date Time Direction Pre-Comp (KB)

Post-Comp (KB)

Network (KB)

Low-bw-optim

E

2010/08/31 11:14 Inbound 47,738 26,634 27,527 1.32 0

2010/08/31 11:14:09 Outbound 14,327 8,638 9,034 1.21 0

88 Using the DD Boost Commands

Page 89: Data Domain Boost Admin Guide 759-0010-0003

bw- Errors

0

0

• network transfer data in KB

• low-bandwidth optimization factor

• number of errors

file-replication show performanceddboost file-replication show performance [interval sec] [count count]

Use this command to display in real time, for a given duration at a specified interval, the amount of pre-compressed outbound and inbound data versus the actual network throughput, or post-compressed data.

Example of Boost file-replication show file history command output:

Date Time Direction

Filename Pre-Comp (KB)

Post-Comp (KB)

Network (KB)

Low-optim

2009/08/31 15:13:09 Inbound /backup/source.tar

47,738 26,634 27,527 1.32

2009/08/31 15:13:09 Outbound

/backup/destin.tar

14,327 8,638 9,034 1.21

DD Boost for OpenStorage Administration Guide 89

Page 90: Data Domain Boost Admin Guide 759-0010-0003

04/30 11:14:16

Outbound Inbound

Pre-comp Network Pre-comp Network

(KB/s) (KB/s) (KB/s) (KB/s)

--------- --------- --------- ---------

0 0 1644 325

0 0 2901 470

0 0 2430 458

0 0 14390 300

0 0 0 70

0 0 2308 446

0 0 2814 552

file-replication show statsddboost file-replication show stats

Use this command to monitor outbound and inbound traffic on a Data Domain system during replication. The compression ratio increases when low-bandwidth optimization is enabled.

90 Using the DD Boost Commands

Page 91: Data Domain Boost Admin Guide 759-0010-0003

Direction: OutboundNetwork bytes sent: 88,383,976Pre-compressed bytes sent: 436,874,240Bytes after filtering: 153,080,417Bytes after low-bw-optim: 145,547,868Bytes after local compression: 83,628,271Compression ratio: 4.9

Direction: InboundNetwork bytes received: 88,383,976Pre-compressed bytes received: 436,874,240Bytes after filtering: 153,080,417Bytes after low-bw-optim: 145,547,868Bytes after local compression: 83,628,271Compression ratio: 4.9

option

option resetddboost option reset distributed-segment processing

Administrators use this command to reset distributed segment processing to the default option, which is enabled.

option set ddboost option set distributed-segment-processing {enabled | disabled}

Administrators can use this command to enable or disable the distributed segment processing feature on the DD OS. By default, it is enabled for DD OS 5.0. If this feature presents any problem for a media server, use this command to disable the feature on the Data Domain system.

Distributed segment processing is supported only if the installed version of the OST plug-in is version 2.2 or later, and the feature is enabled on the DD OS.

DD Boost for OpenStorage Administration Guide 91

Page 92: Data Domain Boost Admin Guide 759-0010-0003

Notes:

Distributed segment processing is enabled by default in DD OS 4.8.

• If a system is upgraded from DD OS 4.6.x or 4.7.x to DD OS 4.8, and the DD Boost license is installed at the time of the upgrade, distributed segment processing is not automatically enabled.

• If a system is upgraded from DD OS 4.9 to DD OS 5.0 and the boost option was disabled before the upgrade, then the distributed-segment-processing option is disabled after the upgrade.

Distributed segment processing feature is always enabled in a Global Deduplication Array, and it cannot be disabled.

option showddboost option show distributed-segment processing

Use this command to show whether the distributed segment processing option is enabled or disabled.

reset

reset statsddboost reset stats

Administrators use this command as follows:

• to reset all statistics when DD Boost is enabled, or

• as a network recovery procedure to clear job connections after the network connection has been lost.

92 Using the DD Boost Commands

Page 93: Data Domain Boost Admin Guide 759-0010-0003

show

show connectionsddboost show connections

Use this command to show the following information:

• the number of active clients, and for each active client:

• the client’s name

• whether or not the client is idle (yes/no)

• the number of installed CPUs

• the amount of memory in MiB

• the installed OST plug-in version number

• the name and version of the operating system

• the backup application’s version number.

• the number of connections that a system uses for DD Boost, and whether these connections are spread across interfaces using Advanced Load Balancing and Link Failover. (See sample output for client connections below.)

• the number of connections used for a given group, even when the interface has been removed from the ifgroup.

• an overview of interfaces available for DD Boost.

Note: For a Global Deduplication Array, the ifgroup status is always disabled, and the Member column value is always no.

DD Boost for OpenStorage Administration Guide 93

Page 94: Data Domain Boost Admin Guide 759-0010-0003

Client Connections:

Max Client Connections: 149

ifgroup status: Enabled

Interface ifgroup -------------- Connections --------

member Backup Restore Control * Total

----------------- -------- -------- -------- -------- --------

192.168.54.138 yes 15 0 2 17

192.168.52.192 yes 15 0 3 18

192.168.55.206 yes 16 0 3 19

----------------- -------- -------- -------- -------- --------

Total Connections 46 0 8 54

----------------- -------- -------- -------- -------- --------* Control connections for file-replication, file operations

94 Using the DD Boost Commands

Page 95: Data Domain Boost Admin Guide 759-0010-0003

show histogramddboost show histogram op

Use this command to display a DD Boost histogram for the Data Domain system.

show statsddboost show stats [interval seconds] [count count]

Use this command to show the output of previous show stats command, the number of bytes written to and read from files contained in storage units, and the number of files created and deleted from storage units. The number of errors encountered for each operation is also shown. Optionally, you can show statistics for a specific number of seconds. The count displays the number of lines equal to the count value.

If distributed segment processing is enabled, the number of bytes transferred via distributed segment processing and the amount of compression achieved is displayed.

op The name of the NFS operation.

mean-ms The mathematical mean time for completion of the operations.

stddev The standard deviation for time to complete operations, derived from the mean time.

max-s The maximum time taken for a single operation.

2,4,6,8, or 10ms

The number of operations that took less than the specified number of milliseconds (ms).

100ms The number of operations that took between 10 ms and 100 ms.

1s The number of operations that took between 100 ms and one second.

10s The number of operations that took between 1 second and 10 seconds.

>10s The number of operations that took over 10 seconds.

DD Boost for OpenStorage Administration Guide 95

Page 96: Data Domain Boost Admin Guide 759-0010-0003

statusddboost status

Enter this command to determine whether DD Boost is enabled or disabled.

storage-unit

storage-unit createddboost storage-unit create storage-unit-name

Administrators use this command to create a storage unit with a given name.

storage-unit deleteddboost storage-unit delete storage-unit-name

Administrators use this command to delete a specified storage unit and all of its contents. You must also manually remove (expire) the corresponding catalog entries.

storage-unit showddboost storage-unit show [compression] [storage-unit-name]

Use this command to display the names of all storage units or, optionally, the names of all files in a specified storage unit.

To display the compression for all storage units (the original byte size, global compression, and local compression for all storage units), enter the compression option.

Note: To interrupt the output of this command, press Ctrl+C.

96 Using the DD Boost Commands

Page 97: Data Domain Boost Admin Guide 759-0010-0003

user-name

reset ddboost reset user-name

Use this command to delete the specified DD Boost user.

set ddboost set user-name user-name

Administrators use this command to set the DD Boost user name when DD Boost is enabled.

showddboost show user-name

Use this command to display the current DD Boost user.

DD Boost for OpenStorage Administration Guide 97

Page 98: Data Domain Boost Admin Guide 759-0010-0003

98 Using the DD Boost Commands

Page 99: Data Domain Boost Admin Guide 759-0010-0003

6 Administration

This chapter covers the following major topics:

• Data Domain System Administration on page 99

• NetBackup Administration on page 104

• Backup Exec Administration on page 106

Data Domain System AdministrationThis section covers the following topics:

• Restricting Export Permissions to DD Boost on page 99

• Optimized Duplication Version Compatibility on page 101

• Modifying an Interface Group on page 101

Restricting Export Permissions to DD BoostData Domain systems export the default mount created for DD Boost /backup/ost as follows:

/backup/ost * (rw,no_root_squash,no_all_squash,insecure)

By default, with this export definition, the DD Boost service is accessible to all media server clients. To restrict access to a certain set of media servers, remove this default export definition and add a new export definition to specify only those media servers.

DD Boost for OpenStorage Administration Guide 99

Page 100: Data Domain Boost Admin Guide 759-0010-0003

This example shows removing the default export and adding a new export definition with access restricted to two specific media servers, mediaserver1.datadomain.com and mediaserver2.datadomain.com:

ddboost disable nfs del /backup/ost * nfs add /backup/ost mediaserver1.datadomain.com mediaserver2.datadomain.com (rw,no_root_squash,no_all_squash,insecure) ddboost enable

This set of steps creates an export entry that enables DD Boost access only to the two specified media servers. You must explicitly specify the export options (rw,no_root_squash, no_all_squash,insecure) that are to override the default export option of secure. The insecure option is required to allow the DD Boost client software to use a broader range of host-side TCP port numbers.

If there is no specific export entry established, the ddboost enable operation installs the default export entry, which allows all hosts to access the DD Boost service. However, if there is any export entry already established for /backup/ost, the ddboost enable operation does not modify the export list, thus allowing the already-installed export controls to be honored.

Prior to DD OS 4.9.1, the default /backup/ost * entry was always added during ddboost enable.

Notes:

Disabling DD Boost disables data access to all media servers.

Administrators need to ensure that no backup jobs are running to the Data Domain system during these operations.

A fully-qualified domain name, an IP address, or a DNS resolvable name of the client must be specified during the modification of the client access list.

The rw option is required on the export entry to allow the media server to write backup data to the Data Domain system.

100 Administration

Page 101: Data Domain Boost Admin Guide 759-0010-0003

Optimized Duplication Version CompatibilityThe Data Domain policy of upgrade compatibility for optimized duplication follows:

• All maintenance and patch versions within a family, are backwardly compatible. A family is identified by the first two digits of the release number, such as 4.8. For example, 4.8.0.0, 4.8.0.2, 4.8.1.0, and 4.8.2.0 are backwardly compatible.

• Optimized duplication is backward compatible across two consecutive release families, such as 4.6 and 4.5, although only the current release within each family is tested.

• The destination Data Domain system must be at the highest version. Cases in which the destination node is at a lower revision than the source node or nodes are not supported.

• For bidirectional optimized duplication, both destination and source must run the same release.

• Optimized duplication over WAN should use the Data Domain replication command to adjust for low bandwidth and long latency.

• To configure encrypted optimized duplication, both the source and the destination must run DD OS 5.0 or later.

Modifying an Interface GroupAfter the interface group is setup, you can add or delete interfaces from the group. The following example shows how to remove an interface from the configured interface group on the Data Domain system.

1. Make sure that no jobs are active from the backup application to the Data Domain system on the interface that you wish to remove from the group. You can do this from the Data Domain system by checking the status of existing connections in the interface group by enter the following command:

• # ddboost show connections

DD Boost for OpenStorage Administration Guide 101

Page 102: Data Domain Boost Admin Guide 759-0010-0003

Sample output

Client Connections:

Max Client Connections: 149

ifgroup status: Enabled

Interface ifgroup -------------- Connections --------

member Backup Restore Control * Total

----------------- -------- -------- -------- -------- --------

192.168.54.138 yes 15 0 2 17

192.168.52.192 yes 15 0 3 18

192.168.55.206 yes 16 0 3 19

----------------- -------- -------- -------- -------- --------

Total Connections 46 0 8 54

----------------- -------- -------- -------- -------- --------* Control connections for file-replication, file operations

:

Figure 6-1: Sample Output for ddboost ifgroup show connections Command

2. Remove the interface from the group on Data Domain system:

# ddboost ifgroup del 192.168.1.3

After this, the interface 192.168.1.3 is released from the group and would no longer be used by the DD Boost Storage Server for any jobs from the media servers.

Note: Removing the interface registered with the backup application makes the Data Domain system inaccessible to the media servers. The configuration of the ifgroup on the Data Domain system is not deleted.

102 Administration

Page 103: Data Domain Boost Admin Guide 759-0010-0003

To make any changes to any interface that is added to the interface group on the Data Domain system at the network layer, remove the interface from the group and add it back.

If you make changes using the net command that modify the interfaces, such as enabling an interface that is configured for ifgroup, execute the ddboost show connections command to update the load balancing view. This updating allows the ifgroup to use the interface. See page 93 for more information about the ddboost show connections command.

Removing Advanced Load Balancing and Link Failover Configuration

The following example illustrates removing a configured interface group on the Data Domain system.

1. Make sure that no jobs are active from the backup application to the Data Domain system. You can do this from the Data Domain system by checking the status of existing connections in the interface group by using the following command:

# ddboost ifgroup show connections

See Figure 6-1 on page 102 for sample output.

2. En sure that there are no pending jobs from any of the connected media servers to this system.

3. Disable the feature on the Data Domain system:

# ddboost ifgroup disable

4. Reset the interface group:

# ddboost ifgroup reset

All the interfaces are released from the group. However, media servers can still access the DD Boost storage server on the Data Domain system on the interface registered with the backup application. In the example above, the Data Domain system is still registered with the backup application using 192.168.1.1.

DD Boost for OpenStorage Administration Guide 103

Page 104: Data Domain Boost Admin Guide 759-0010-0003

NetBackup AdministrationThis section covers the following topics and procedures:

• Find your OST plug-in version on page 104

• Find your NetBackup version on page 104

• Network Time-Outs on page 104

• Grouping Storage Units to Provide Failover on page 105

Find your OST plug-in versionEnter:

# bpstsinfo -pi

The output shows the vendor version, the plug-in version, and the build version.

Find your NetBackup version

NetBackup

Search the file [NetbackupInstall_Dir] version.

Sample output from this command looks like:

HARDWARE SOLARIS

VERSION NetBackup? 6.5

RELEASEDATE Mon Jul 23 16:30:00 CDT 2009

BUILDNUMBER 20070723

Network Time-Outs

Backup and restore jobs often take a long time to complete. Although the OST plug-in can recover from temporary network interruptions, the operating system on the backup application system might terminate a job prematurely if the backup application time-outs are set too low.

Data Domain recommends setting time-outs to at least 30 minutes (1800 seconds).

104 Administration

Page 105: Data Domain Boost Admin Guide 759-0010-0003

Note: After losing a network connection, administrators should issue the ddboost reset stats command to clear job connections.

Set backup application time-out using the CLI

Add the following two lines to the file[NetBackupInstall_directory]/bp.conf:

CLIENT_CONNECT_TIMEOUT = 1800

CLIENT_READ_TIMEOUT = 1800

Note: The time-out value is expressed in seconds.

Set backup application time-out using the GUI

1. Expand the NetBackup Management node.

2. Expand Host Properties.

3. Select Master Servers.

4. In the right pane, double-click the machine name.

In the property dialog box that is displayed, change the time-out values.

Grouping Storage Units to Provide Failover

The administrator can specify a group of storage units to share a workload. The administrator tells the backup application system how to choose among the storage units in the group for the next job by setting one of the following selection criteria:

• Failover (This is the recommended setting)

Setting failover as the selection criterion ensures that a backup job does not fail if the storage unit to which it is directed fails. The backup application chooses another storage unit in the same group to finish the job.

• Prioritized

• Round robin

• Load balance

DD Boost for OpenStorage Administration Guide 105

Page 106: Data Domain Boost Admin Guide 759-0010-0003

Delete a Data Domain storage server

Warning:This procedure removes all of the data and resources associated with the storage server. Do not attempt this procedure unless it is necessary.

1. Delete all of the files specified by the BACKUP_ID by entering:

# bpexpdate -backupid BACKUP_ID -d 0

2. Delete all of the policies from the GUI.

3. Delete all of the storage units by entering:

# bpstudel -label SU_NAME

4. Delete all the disk pools by entering:

# nbdevconfig -deletedp -stype DataDomain -dp pool-name

5. Delete the storage server by entering:

# nbdevconfig -deletests -storage_server dd22 -stype DataDomain

Note: You can use the GUI to delete the files, lifecycle policies, storage units, and disk pools.

For troubleshooting information, see Unable to Delete the Data Domain System on page 110.

6. Remove the credential using the tpconfig command.

# tpconfig -update-storage_server dd22 -stype DataDomain -sts_user_id username -password password

Backup Exec AdministrationThis section covers the following topics:

• Find your OST plug-in version on page 107

• Find your Backup Exec version on page 107

• Delete storage units on Data Domain Systems on page 107

• Recover backup files on an OpenStorage device on page 107

106 Administration

Page 107: Data Domain Boost Admin Guide 759-0010-0003

Find your OST plug-in version1. Go to the Backup Exec install directory and find the file

libstspiDataDomain.dll.

2. Right-click the file’s name and select Properties from the menu.

3. Select the Details tab. The OST plug-in version is displayed as the file version.

Find your Backup Exec versionFrom the Backup Exec Home page, select About from the Help menu.

Delete storage units on Data Domain SystemsThere are two options for deleting a storage unit on a Data Domain system:

• You can erase all media within a Backup Exec device (a Data Domain system’s storage unit) and then delete the device from Backup Exec.

• You can also delete the device from Backup Exec even if media remains in the device. The storage unit remains on the Data Domain system and some files are left in the storage unit. To recover this space, delete the storage unit on the Data Domain system by entering:

# ddboost storage-unit delete storage-unit name

Recover backup files on an OpenStorage device1. From the Backup Exec Home page, select the Devices tab.

2. Select the Data Domain system storage unit on the Devices page.

3. Select a media label.

4. Right-click the media label, and select Restore from the menu.

DD Boost for OpenStorage Administration Guide 107

Page 108: Data Domain Boost Admin Guide 759-0010-0003

108 Administration

Page 109: Data Domain Boost Admin Guide 759-0010-0003

7 Basic Troubleshooting

This chapter provides basic troubleshooting tips that might enable customers to resolve issues on their own. For issues that cannot be resolved, customers should contact their contracted support providers.

This chapter covers the following topics:

• General Troubleshooting on page 109

• Data Domain System Settings for File-Replication on page 110

• NetBackup Troubleshooting on page 110

• Backup Exec Troubleshooting on page 118

For more information, see the Data Domain Knowledge Base, which is available at (https: //my.datadomain.com.

General Troubleshooting When investigating problems, be aware that the DD Boost software has components on both a Data Domain system and a backup application system. The two environments must be compatible. The following troubleshooting considerations apply to both systems:

• Supported Configurations

Ensure that you have a supported configuration as specified in the DD Boost for OpenStorage Compatibility List. A supported configuration can become unsupported if any component changes.

This list is available from the Data Domain Support portal (https: //my.datadomain.com). Navigate to the Documentation > Compatibility List page and select DD Boost Compatibility List.

DD Boost for OpenStorage Administration Guide 109

Page 110: Data Domain Boost Admin Guide 759-0010-0003

• Authorization Failures

If you encounter authorization failures, ensure that all of the systems have correct access credentials for the other systems. Configuring a Media Server on page 46 provides instructions on establishing user credentials.

Data Domain System Settings for File-Replication

For all DD OS versions, the replication throttle command controls replication. Setting the throttle too low can lead to optimized duplications to fail for NetBackup and Backup Exec.

NetBackup Troubleshooting

Unable to Delete the Data Domain SystemThis procedure assumes the following:

• You are unable to delete the Data Domain system.

• You have already run the nbdevconfig command with the deletests option and it has failed, which means that the emm or rmms process might be down.

• All of the files for the specified Data Domain have expired. For instructions on how to expire a file, see your NBU documentation.

If you are still unable to delete the Data Domain system, follow these steps:

1. Enter:

# nbdevconfig -deletests -storage_server DDR -stype DataDomain

2. If core files result, contact Data Domain Support. Otherwise, continue to the next step.

3. Follow the instructions below for your operating system.

110 Basic Troubleshooting

Page 111: Data Domain Boost Admin Guide 759-0010-0003

On a Windows System

1. Restart the NetBackup services on the media server by running these two executable files:

NBUInstallPath\NetBackup\bin\bpdown.exe

NBUInstallPath\NetBackup\bin\bpup.exe

2. Run deletests again. If it fails, enable more detailed NBU logging by opening the NBUInstallPath\NetBackup\nblog.conf file and adding this entry:

NBSTSI=OID=202

3. Enable detailed logging messages on media servers as described in Error Logging on the Media Servers on page 113.

On a UNIX System

1. If rmms restarts but emm does not, verify that all of the processes are up, especially emm or rmms.

2. If these processes are not up, enter:

# /bp/bin/goodies/netbackup start

3. Run deletests again. If it still fails, enable more NBU logging by opening the /bp/nblog.conf file and adding this entry:

NBSTSI=OID=202

4. Enable detailed logging messages as described in Error Logging on the Media Servers on page 113.

Check the InstallationProblems with basic operations such as backups may result from improper installation.

1. Verify that the files are in the correct location by entering the following, depending on your operating system:

a. On a UNIX system, enter:

# ls /usr/openv/lib/ost-plugins/

DD Boost for OpenStorage Administration Guide 111

Page 112: Data Domain Boost Admin Guide 759-0010-0003

The command output should include the names of the shared library files:

libstspiDataDomain.so

libstspiDataDomainMT.so

a. On a Windows system, enter:

C:\Program Files\Veritas\bin\ost-plugins

The command output should be the name of the shared library file libstspiDataDomain.dll.

2. Determine the plug-in version by entering:

# bpstsinfo -pi

The vendor version shown in the output is the Data Domain plug-in version, and build version is the version of the DD Boost API.

Note: If the bpstsinfo command fails, check the log files in the /usr/openv/netbackup/logs/admin directory.

Check CredentialsTo display credentials for all Data Domain systems registered as storage servers, enter the following command from the backup application system:

# tpconfig -dsh -all_hosts -stype DataDomain

If you receive a message stating that you failed to add credentials for the Data Domain system (OpenStorage server), follow the procedure Adding Credentials on page 48, which describes how to set up credentials and check for errors and inconsistencies.

Resolve License ErrorIf the Configure Disk Pool wizard reports a license error, do the following:

1. Open the file bp.conf.

2. Check if it contains an extra CLIENT_NAME entry.

3. Delete any extra CLIENT_NAME entry.

112 Basic Troubleshooting

Page 113: Data Domain Boost Admin Guide 759-0010-0003

Note: An extra entry can occur after upgrading NetBackup from version 6.0 to 6.5.

Error Logging on the Media ServersThe error log is the main tool for troubleshooting problems related to NetBackup in an OpenStorage environment. Before starting a backup, restore, or optimized duplication operation, enable logging on the NetBackup media server. Follow the instructions for the media server’s operating system, or use the NetBackup GUI.

Enable Error Logging on a UNIX System

Enter:

# /usr/openv/netbackup/logs/mklogdir

Enable Error Logging on a Windows System

Enter:

C:\Program Files\Netbackup\logs\mklogdir.bat

Enable logging via the GUI

1. Open the NetBackup Administration Console’s Devices window.

1. In left pane of this window, expand the NetBackup Management node.

2. Expand Host Properties and select Master Servers.

3. In the right pane, double-click the machine name.

4. In the Property directory tree, select Logging, which displays the Logging dialog box.

DD Boost for OpenStorage Administration Guide 113

Page 114: Data Domain Boost Admin Guide 759-0010-0003

5. Set the Global Logging level to 4, and click OK.

After you have enabled logging, the OST plug-in prefixes error and informational log messages with the name DataDomain.

Resolving Failed Backups on Media ServersSearch for plug-in error messages in the log file as described below for the media server’s operating system.

Resolve failed backups on a UNIX system

Enter:

# cat /usr/openv/netbackup/logs/bptm/LOGFILE_DATE | grep DataDomain

The command selects lines from the specified log file that contain the word DataDomain. The plug-in uses DataDomain as a prefix for its log messages.

Resolve failed backups on a Windows system

1. Enter:

C:\Program Files\Veritas\logs\bptm\LOGFILE_DATE.log

2. Open the log file and search for the word DataDomain.

114 Basic Troubleshooting

Page 115: Data Domain Boost Admin Guide 759-0010-0003

Resolve failed file duplication

1. Search for plug-in error messages in the media server log files, which are specific to the server’s operating system:

UNIX

• For read_file:

/usr/openv/netbackup/logs/bpdm

• For write_file:

/usr/openv/netbackup/logs/bptm

• For file-replication:

/usr/openv/netbackup/logs/bpdm

Windows

• For read_file:

C:\Program Files\Veritas\logs\bpdm

• For write_file:

C:\Program Files\Veritas\logs\bptm

• For file-replication:

C:\Program Files\Veritas\logs\bpdm

2. Verify that the replication license is installed by entering:

# license show

3. For further assistance, contact your contracted support provider.

Resolve time-out error

1. Verify that the client can ping the Data Domain system.

2. Verify that the file system is running on the Data Domain system by entering:

# filesys status

3. Verify that NFS is running on the Data Domain system by entering:

DD Boost for OpenStorage Administration Guide 115

Page 116: Data Domain Boost Admin Guide 759-0010-0003

# nfs status

Plug-In Log MessagesWhen the plug-in encounters an error, it returns an EPLUGIN error code to NetBackup and logs a reason for the error.

1. Determine if the reason is one of the following:

• Write Length Exceeds Limit Error

The write buffer data size is limited. If you receive an exceeds limit error message, change the buffer size to a value within the specified limit as described in Configuring Buffers on page 55.

• Program Not Registered

The following output indicates that the program is not registered:

(: RPC: Program not registered)

2. Enable DD Boost by installing a valid license:

# license add ddboost-license-code

3. Verify that the file system is running on the Data Domain system by entering:

# filesys status

Cannot Connect on Socket ErrorThis error results when the command nbdevconfig -creatests has been run, but the storage server is not created because of a socket connection error.

Follow these steps:

1. Check to make sure the nbemm process is running. If it keeps failing upon startup, usually there is an issue with the NBU database.

2. Use the vxlogview utility to check the logs located in /usr/openv/logs/51216-*.log for errors.

3. Recreate the Database. Enter:

116 Basic Troubleshooting

Page 117: Data Domain Boost Admin Guide 759-0010-0003

# /usr/openv/db/bin/create_nbdb -drop

NetBackup Backup Jobs Fail on Solaris Media Servers

If a file backup job fails with a media write error (84) at the start of the job, a typical activity monitor job detail might contain the following:

2/28/2009 3:36:22 AM - Critical bptm(pid=1750) failure to open sts for storage server apoddrrp01: plug-in reports error 2060046 plugin error

2/28/2009 3:36:23 AM - end writing media open error(83)

The bptm log may contain information similar to the following:

01:33:02.585 [28874] <16> apoddrrp01: /usr/openv/lib/ost-plugins/libstspiDataDomain.so:stspi_open_server STS_EPLUGIN Can't connect to mountd on apoddrrp01 (: RPC: Miscellaneous tli error - An event requires attentionError 0)

In the above example, an entry in/etc/inet/ipsecinit.conf has enforced encryption on traffic from port 665 (sun-dr). However, the Solaris operating system had Sun Dynamic reconfiguration disabled. As a result, although the media server used port 665 to connect via NFS to the Data Domain system, the packet did not leave the media server because it was not encrypted.

To fix this problem, you need to disable dynamic reconfiguration.

Disable dynamic reconfiguration

1. Uncomment or remove sun-dr entries in /etc/inet/inetd.conf:

sun-dr stream tcp wait root /usr/lib/dcs dcs

sun-dr stream tcp6 wait root /usr/lib/dcs dcs

2. Have inetd reread the configuration file, by entering:

kill -HUP pid-inetd

DD Boost for OpenStorage Administration Guide 117

Page 118: Data Domain Boost Admin Guide 759-0010-0003

3. Uncomment or remove the sun-dr entries in /etc/inet/ipsecinit.conf:

{dport sun-dr ulp tcp} permit {auth_algs md5}

{sport sun-dr ulp tcp} apply {auth_algs md5 sa unique}

4. Remove the active IPsec configuration from the running system.

a. Obtain the index numbers by entering:

ipsecconf |grep sun-dr

b. Delete the policy for sun-dr by entering:

ipsecconf -d index

Optimized Duplication Job FailsThe replicator software license for optimized duplication is required on both the source and destination Data Domain systems that run DD OS 4.7 or later.

If this license is not installed, an optimized duplication job fails. A typical activity monitor job detail indicates a media write error (84) occurred. The NetBackup bpdm log states that the NFS operation is not supported.

Add license for replicator

1. Obtain a replicator license code from Data Domain.

2. From the command-line interface on each Data Domain system, add the license code:

# license add license code

Backup Exec Troubleshooting

Basic Troubleshooting• Verify that the concurrent connections (jobs) count is set

properly for all storage units.

118 Basic Troubleshooting

Page 119: Data Domain Boost Admin Guide 759-0010-0003

• Backup Exec: The total number of concurrent connections from a single media server plug-in to all associated OpenStorage storage units is 16. This number was specified when you configured the device. See Configuring Devices on page 63.

• When encountering a problem, try to stop Backup Exec services and restart them. If this does not work:

• Reboot the server.

• Start the debugger and try to recreate the problem.

Check the InstallationProblems with basic operations such as backups may result from improper installation.

1. Verify that libstspiDataDomain.dll is in C:\Program Files\Symantec\Backup Exec.

2. Determine the plug-in version by right-clicking on the DLL and opening its Properties > Details.

Check Credentials for a Data Domain system1. From the Backup Exec Home page, go to the Devices page.

2. Right-click the OpenStorage device and display its Properties. Note the logon account.

3. From the system menu go to Network > Logon Account Management.

4. Select the logon account and verify its user name. Try to edit the account to verify the password. This user name and password should match the user name set for DD Boost and password on the Data Domain system.

Resolve License Error1. If the OpenStorage option is not enabled, from the Backup Exec

Tools menu select Install Options and License Keys on this Media server.

DD Boost for OpenStorage Administration Guide 119

Page 120: Data Domain Boost Admin Guide 759-0010-0003

2. Click Next to go to Configure Options. See Figure 7-1.

3. Open the Backup Exec Options and verify that the Deduplication Option is selected.

4. Click Cancel to avoid making unintended changes.

Figure 7-1: Backup Exec Review Features for Installation Page

Set up active debuggingUse the Backup Exec debugging utility to troubleshoot Backup Exec issues.

1. From the Backup Exec Home page, from the Tools menu select Support Utilities > Run the Debug Monitor for Active Debugging.

The Backup Exec Debug Monitor is displayed.

120 Basic Troubleshooting

Page 121: Data Domain Boost Admin Guide 759-0010-0003

Figure 7-2: Backup Exec Debug Monitor

2. The following Capture options must be selected (enabled): Job Engine, Backup Exec Server, and Device and Media

3. Capture to file must be enabled.

4. From the Tools > Settings menu, select the Device and Media Debug setting (see Figure 7-3). Select Enable verbose logging if it is not enabled.

DD Boost for OpenStorage Administration Guide 121

Page 122: Data Domain Boost Admin Guide 759-0010-0003

Figure 7-3: Settings Menu

The log file that is captured is named media server-SGMon.txt. It is located in the logs directory.

122 Basic Troubleshooting