Data Domain OST User Guide - Symantec

Data Domain OpenStorage (OST) 

User Guide 

Release OST 1.1

Disclaimer 

Notices 

Data Domain Patents 

Copyright 

The information contained in this publication is subject to change without notice. Data Domain, 

Incorporated makes no warranty of any kind with regard to this manual, including, but not limited 

to, the implied warranties of merchantability and fitness for a particular purpose. Data Domain, 

Incorporated shall not be liable for errors contained herein or for incidental or consequential 

damages in connection with the furnishing, performance, or use of this manual. 

Data Domain hardware has been tested and found to comply with the limits for a Class A digital 

device, pursuant to Part 15 of the FCC Rules. 

This Class A digital apparatus complies with Canadian ICES-003. 

Cet appareil numérique de la classe A est conforme à la norme NMB-0003 du Canada. 

These limits are designed to provide reasonable protection against harmful interference when the 

equipment is operated in a commercial environment. This equipment generates, uses, and can 

radiate radio frequency energy and, if not installed and used in accordance with the instruction 

manual, may cause harmful interference to radio communications. Operation of this equipment in a 

residential area is likely to cause harmful interference in which case the user will be required to 

correct the interference at his own expense. 

Changes or modifications not expressly approved by Data Domain can void the user's authority to 

operate the equipment. 

Data Domain products are covered by one or more of the following patents issued to Data Domain. 

U.S. Patents: 6928526, 7007141, 7065619. Data Domain has other patents pending. 

Copyright © 2005 - 2007 Data Domain, Incorporated. All rights reserved. Data Domain, the Data 

Domain logo, OST, Data Domain OS, Global Compression, Data Invulnerability Architecture, and 

all other Data Domain product names and slogans are trademarks or registered trademarks of Data 

Domain, Incorporated in the USA and/or other countries. Microsoft and Windows are either 

registered trademarks or trademarks of Microsoft Corporation in the United States and/or other 

countries. Portions of this product are software covered by the GNU General Public License 

Copyright © 1989, 1991 by Free Software Foundation, Inc. Portions of this product are software 

covered by the GNU Library General Public License Copyright © 1991 by Free Software 

Foundation, Inc. Portions of this product are software covered by the GNU Lesser General Public 

License Copyright © 1991, 1999 by Free Software Foundation, Inc. Portions of this product are 

software covered by the GNU Free Documentation License Copyright © 2000, 2001, 2002, by Free 

Software Foundation, Inc. Portions of this product are software covered by the GNU Free 

Documentation License Copyright © 2000, 2001, 2002 by Free Software Foundation, Inc. Portions 

of this product are software Copyright © 1999 - 2003, by The OpenLDAP Foundation. Portions of 

this product are software developed by the OpenSSL Project for use in the OpenSSL Toolkit 

(http://www.openssl.org/), Copyright © 1998-2005 The OpenSSL Project, all rights reserved.

Portions Copyright © 1999-2003 Apple Computer, Inc. All rights Reserved. Portions of this 

product are Copyright © 1995 - 1998 Eric Young (eay@cryptsoft.com) All rights reserved. 

Portions of this product are Copyright © Ian F. Darwin 1986-1995. All rights reserved. Portions of 

this product are Copyright © Mark Lord 1994-2004. All rights reserved. Portions of this product 

are Copyright © 1989-1997 Larry Wall All rights reserved. Portions of this product are Copyright 

© Mike Glover 1995, 1996, 1997, 1998, 1999. All rights reserved. Portions of this product are 

Copyright © 1992 by Panagiotis Tsirigotis. All rights reserved. Portions of this product are 

Copyright © 2000-2002 Japan Network Information Center. All rights reserved. Portions of this 

product are Copyright © 1988-2003 by Bram Moolenaar. All rights reserved. Portions of this 

product are Copyright © 1994-2006 Lua.org, PUC-Rio. Portions of this product are Copyright © 

1990-2005 Info-ZIP. All rights reserved. Portions of this product are under the Boost Software 

License - Version 1.0 - August 17th, 2003. All rights reserved. Portions of this product are 

Copyright © 1994 Purdue Research Foundation. All rights reserved. This product includes 

cryptographic software written by Eric Young (eay@cryptsoft.com). Portions of this product are 

Berkeley Software Distribution software, Copyright © 1988 - 2004 by the Regents of the 

University of California, University of California, Berkeley. Portions of this product are software 

Copyright © 1990 - 1999 by Sleepycat Software. Portions of this product are software Copyright © 

1985-2004 by the Massachusetts Institute of Technology. All rights reserved. Portions of this 

product are Copyright © 1999, 2000, 2001, 2002 The Board of Trustees of the University of 

Illinois. All rights reserved. Portions of this product are LILO program code, Copyright © 1992 - 

1998 Werner Almesberger. All rights reserved. Portions of this product are software Copyright © 

1999 - 2004 The Apache Software Foundation, licensed under the Apache License, Version 2.0 

(http://www.apache.org/licenses /LICENSE-2.0). Portions of this product are derived from 

software Copyright © 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002 by Cold Spring 

Harbor Laboratory. Funded under Grant P41-RR02188 by the National Institutes of Health. 

Portions of this product are derived from software Copyright © 1996, 1997, 1998, 1999, 2000, 

2001, 2002 byBoutell.Com, Inc. Portions of this product relating to GD2 format are derived from 

software Copyright © 1999, 2000, 2001, 2002 Philip Warner. Portions of this product relating to 

PNG are derived from software Copyright © 1999, 2000, 2001, 2002 Greg Roelofs. Portions of this 

product relating to gdttf.c are derived from software Copyright © 1999, 2000, 2001, 2002 John 

Ellson (ellson@lucent.com). Portions of this product relating to gdft.c are derived from software 

Copyright © 2001, 2002 John Ellson (ellson@lucent.com). Portions of this product relating to 

JPEG and to color quantization are derived from software Copyright © 2000,2001, 2002, Doug 

Becker and copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, Thomas G. Lane. 

This software is based in part on the work of the Independent JPEG Group. Portions of this product 

relating to WBMP are derived from software Copyright © 2000, 2001, 2002 Maurice Szmurlo and 

Johan Van den Brande. 

Other product names and/or slogans mentioned herein may be trademarks or registered trademarks 

of their respective companies.

Data Domain, Incorporated 

2421 Mission College Blvd. 

Santa Clara, CA 95054 

USA 

Phone 408-980-4800 Direct 

877-207-3282 Toll-free 

Fax 408-980-8620 

www.datadomain.com 

May 2008 

Part number: 759-0001-0001 Rev. C

Contents 

About This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9 

Guide Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 

Related Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 

Typographic Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11 

Contacting Data Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 

For Help with Technical Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 

For Sales and License Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 

Chapter 1: Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13 

Chapter 2: Preparing to Install OST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15 

Obtaining a License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 

Supported Configurations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 

Using NetBackup Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 

What Plug-in Version Is Installed? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 

Chapter 3: Installing OST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19 

Enabling OST on the Data Domain System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 

Installing the Data Domain OST Plug-in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 

UNIX Plug-in Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 

Windows Plug-in Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 

Chapter 4: OST Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25 

Configuring the Data Domain System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 

About Naming the Data Domain OST Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 

Create Logical Storage Units (LSUs) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 

5

Configuring the NetBackup Media Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 

Step 1: Register the Data Domain OST Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 

Step 2: Add Credentials for the Data Domain System . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 

Step 3: Create Disk Pools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 

Step 4: Create Storage Units . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 

Step 5: Create a Backup Policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 

Chapter 5: Configuring Optimized Duplication . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 

Chapter 6: OST Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 

Adding the OST License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 

Adding an OST User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 

Setting the OST User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 

Reverting to No OST User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 

Displaying the OST User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 

Enabling OST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 

Disabling OST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 

Is OST Is Enabled or Disabled? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 

Creating an LSU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 

Deleting an LSU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 

Deleting all LSUs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 

Displaying LSU Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 

Viewing OST Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 

Viewing OST Statistics over an Interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 

Viewing OST Operation Latencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 

Clearing OST Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 

Viewing OST Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 

Displaying Statistics for Active Optimized Duplication Operations . . . . . . . . . . . . . . . . . . . . 48 

Chapter 7: Operation and Maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 

Uninstalling the Data Domain OST Plug-in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 

Upgrading the OST Plug-in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 

6 OST User Guide

Deleting the Data Domain Storage Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 

Grouping Storage Units to Provide Failover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 

Duplicating Images (NBU Workaround) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 

Setting Network Time-outs on the NetBackup System . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 

Chapter 8: Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .55 

General Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 

Troubleshooting the Data Domain System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 

Show Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 

Data Domain Log File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 

If You Cannot Delete the Data Domain Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 

Troubleshooting the NetBackup Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 

Checking the Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 

Checking Credentials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 

Configuration Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 

Error Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 

Failed Backups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 

Failed Image Duplication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 

Plug-in Log Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 

Cannot Connect on Socket . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 

Contents 7


About This Guide 

This Guide explains how to install, configure, and use Data Domain OST with Data Domain 

systems. It is intended for system administrators who are familiar with standard backup software 

packages and with general backup administration. 

Guide Overview 

This Guide consists of the following chapters: 

• “Introduction” on page 13 introduces Data Domain OST. 

• “Preparing to Install OST” on page 15 describes prerequisites for installing the Data Domain 

OST plug-in. 

• “Installing OST” on page 19 explains how to install the Data Domain OST plug-in on a 

NetBackup media server. 

• “OST Configuration” on page 25 explains how to configure the Data Domain system and the 

NetBackup media server for Data Domain OST. 

• “Configuring Optimized Duplication” on page 35 explains how to configure the optimized 

duplication feature. 

• “OST Commands” on page 39 describes Data Domain Command Line Interface (CLI) 

commands that you use for Data Domain OST. 

• “Operation and Maintenance” on page 49 provides information about operation and 

maintenance, such as setting network time-outs, upgrading the plug-in, and deleting the Data 

Domain Storage server. 

• “Troubleshooting” on page 55 describes techniques for investigating problems. 

9

Related Documents 

Related Documents 

Complete documentation for the operating system that runs on your Data Domain system is 

available on the Software Downloads page of the Data Domain Support web site. To open a 

document, find the correct version of the OpenStorage (OST) Release and click its book icon. 

Note Data Domain supports the OST feature in DD OS version 4.4.0.0 and later. 

You can find NetBackup OST documentation at: www.symantec.com/enterprise/support/index.jsp. 

From the general Symantec support page, navigate to the NetBackup Server product page and 

search the knowledge base for Documentation. 

Tip 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) 

You can find training materials at www.symantec.com/enterprise/training/index.jsp 

To view the Symantec Veritas NetBackup Hardware Compatibility List (HCL), go to 

support.veritas.com/docs/284599 


Typographic Conventions 

The typefaces and symbols used in this Guide are described below. 

Typeface Usage Examples 

Monospace Commands, computer output, file contents, 

files, directories, software elements such as 

command options, and parameters 

Italic New terms, book titles, variables, and labels 

of boxes and windows as seen on a monitor 

Monospace 

bold 

User input. In command lines, the command 

prompt precedes the user input. 

Symbol Usage Examples 

# Administrative user prompt 

[ ] In a command synopsis, brackets indicate an 

optional argument 

| In a command synopsis, a vertical bar 

separates mutually exclusive arguments 

{ } In a command synopsis, curly brackets 

indicate that one of the exclusive arguments 

is required. 

Typographic Conventions 

Find the log file under /var/log. 

See the net help page for more 

information. 

The name is a path for the device.... 

# config setup 

log view [filename] 

net dhcp [true | false] 

adminhost add 

{ftp | telnet | ssh} 

About This Guide 11

Contacting Data Domain 

Contacting Data Domain 

General Contact Information 

Data Domain, Incorporated 

2421 Mission College Blvd. 

Santa Clara, CA 95054 

USA 

Phone 408-980-4800 Direct 

877-207-3282 Toll-free 

Fax 408-980-8620 

For Help with Technical Problems 

Contact Data Domain Technical Support: 

• Phone, 24 hours a day, 7 days a week: 

- Toll free: 877-207-DATA (3282) 

- Direct: 408-980-4900 

• E-mail: support@datadomain.com 

For Sales and License Information 

To reach a Data Domain representative who can help you with sales and licensing questions, 

contact Data Domain Sales: 

• Phone: 877-622-2587 

• E-mail: sales@datadomain.com 

• Fax: 408-980-8620 


Introduction 1 

OpenStorage (OST) is a feature of Symantec’s Veritas NetBackup backup and recovery product. 

OST integrates NetBackup with disk backup devices, such as Data Domain systems. OST enables 

NetBackup media servers to communicate with disk devices without having to emulate tape used 

by virtual tape libraries (VTL). 

The NetBackup system sets policies that control when backups occur while the storage devices 

control data deduplication, replication, and compression. Administrators manage backup, 

replication, and restores from a single NetBackup console and can use all of Data Domain’s 

intelligent features, including WAN-efficient replicator software. NetBackup manage all images 

(collections of data) in the NetBackup catalog, even if the Data Domain system creates the images. 

In the typical Data Domain OST configuration shown below, each media server is running a 

different (supported) operating system. 

13

Data Domain OST consists of a plug-in that you install on each NetBackup media server that 

communicates with the Data Domain system. A Data Domain system can be either a Data Domain 

appliance, a gateway, or an array. 

The Data Domain system exposes pre-made disk volumes called Logical Store Units (LSUs) to an 

OST-enabled media server. Multiple NetBackup media servers, each with the Data Domain OST 

plug-in, can use the same LSU on a Data Domain system as a storage server. 

The overall steps for installing and configuring OST are as follows: 

1. Obtain the license required to enable OST on the Data Domain system. 

2. Install the Data Domain OST plug-in on each media server. 

3. Configure the Data Domain system. 

4. Configure the NetBackup media server. 

5. Optionally, configure optimized duplication. 


Preparing to Install OST 2 

This chapter covers the following topics: 

• Obtaining a license 

• Supported configurations 

• Using NetBackup commands 

• Determining which Plug-in version has been installed 

Obtaining a License 

You can purchase an OpenStorage license key for Data Domain OST directly from Data Domain. 

• The basic license allows you to back up and restore image 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. 

“Installing OST” on page 19 explains how to use the license key to install the license on a Data 

Domain system. 

Supported Configurations 

Note If you upgrade the Data Domain system to a version with increased OST functionality, you 

must also upgrade the OST plug-in. NetBackup does not keep track of the functionality that 

each plug-in supports. You must perform the upgrade manually. 

Data Domain supports the OST feature on the following Data Domain systems: 

• Data Domain appliances (DD5xx, DD6xx, DD120) 

• Data Domain gateways (DD560g, DD580g, DD690g) 

• Data Domain arrays 

15

Supported Configurations 

The Data Domain OST plug-in is available for the following NetBackup media server platforms: 

• Solaris 9 or 10 (SPARC, 64-bit) 

• RedHat Enterprise Linux 4 (x86 32-bit and x64 64-bit) 

• SUSE Linux Enterprise Server 9/10 (x86 32-bit and x64 64-bit) 

• Microsoft Windows Server 2003 (32-bit server) 

- Supported with 32-bit plug-in on x86 platforms 

• Microsoft Windows Server 2003 (64-bit server) 

- Supported with 64-bit plug-in on x86 and x64 platforms 

The plug-in version must be compatible with your Data Domain and NetBackup configuration. The 

OST Compatibility Matrix shows which versions are compatible. Data Domain does not support 

combinations other than those detailed in the table. 

In the Compatibility Matrix, the Media Server is the operating system on which NetBackup is 

running. This is the system on which you install the Data Domain OST plug-in. The matrix lists 

versions of the Symantec NetBackup, Data Domain OST plug-in, Data Domain operating system, 

media server operating system, and the platform for the Data Domain operating system. Data 

Domain supports the combination of versions shown in any single row of the table. 

Data Domain OST Compatibility Matrix 

Symantec 

NetBackup 

6.5.x 

Data Domain 

OST Plug-in 

1.0.1.x 4.4.x 

4.5.x 

1.1.0.x 4.4.x 

4.5.x 

Data Domain 

OS 

Media Server OS Platform 

Solaris 9 or 10 

RHEL 4 

Solaris 9 or 10 

RHEL 4 

SLES 9/10 

Windows Server 2003 

(32-bit server) 

Windows Server 2003 

(64-bit server) 

SPARC 

x86, x64 

SPARC 

x86, x64 

x86, x64 

16 OST User Guide 

x86 

x86, x64 

In the table, RHEL stands for Red Hat Enterprise Linux—either AS or ES. SLES stands for SuSE 

Linux Enterprise Server. 

Note In addition to the compatibility information listed above, Symantec maintains a hardware 

compatibility list (HCL) at support.veritas.com/docs/284599.

Using NetBackup Commands 

Using NetBackup Commands 

NetBackup (NBU) consists of a master server that manages clients and the media servers. The 

master server is also a media server. Although the OST plug-in is typically installed on media 

servers other than the master server, it can be installed on both kinds of servers. 

Note Commands that run on the command line can by entered on either the master or the media 

server. If you run commands from 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. 

This Guide uses the NetBackup commands located in the following directories, which you need to 

add to your UNIX or Windows PATH: 

• UNIX 

/usr/openv/netbackup/bin 

/usr/openv/netbackup/bin/admincmd 

/usr/openv/volmgr/bin 

• Windows 

C:\Program Files\Veritas\NetBackup\bin 

C:\Program Files\Veritas\NetBackup\bin\admincmd 

C:\Program Files\Veritas\Volmgr\bin 

Add these directory locations to the PATH: 

• UNIX 

$ export 

PATH=$PATH:/usr/openv/netbackup/bin: 

/usr/openv/netbackup/bin/admincmd:/usr/openv/volmgr/bin 

• Windows 

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

C:\Program Files\Veritas\NetBackup\bin\admincmd; 

C:\Program Files\Veritas\Volmgr\bin 

Preparing to Install OST 17

What Plug-in Version Is Installed? 

What Plug-in Version Is Installed? 

If the OST plug-in has already been installed, you can use the bpstsinfo command to determine 

which version is installed. Enter: 

# bpstsinfo -pi 

Plugin Name: libstspiDataDomainMT.so 

Prefix: DataDomain: 

Label: DataDomain Plugin 

Build Version: 9 

Build Version Minor: 4 

Operating Version: 9 

Vendor Version: Protocol version = 1.1.0.0 

Note In the bpstsinfo command output Vendor Version is the Data Domain plug-in version 

and Build Version is the version of the OST API. 

The [NetbackupInstall_Dir] version file contains the detailed version information for 

NetBackup. 

For example: 

HARDWARE SOLARIS 

VERSION NetBackup? 6.5 

RELEASEDATE Mon Jul 23 16:30:00 CDT 2007 

BUILDNUMBER 20070723 


Installing OST 3 

This chapter explains how to install Data Domain OST. Installation consists of — 

• Enabling Data Domain OST on the Data Domain system. 

• Installing the Data Domain OST plug-in on the NetBackup media server. 

The examples in this Guide assume the following configuration: 

• NetBackup media server: load64 running NBU 6.5.1. 

• OST-enabled Data Domain systems: dd22 and dd23. 

Notes For detailed descriptions about the commands, see “OST Commands” on page 39. 

For instructions about uninstalling and upgrading the plug-in, see “Operation and 

Maintenance” on page 49. 

19

Enabling OST on the Data Domain System 


This section describes the installation tasks that you need to perform on the Data Domain system. 

In a typical installation, the OST plug-in software is installed on any NetBackup media server that 

sees and uses the Data Domain system. The following is required for each media server that 

accesses the Data Domain system: 

• The Data Domain OST plug-in must be installed as described in this chapter. 

• Logon credentials to the storage server must be configured. 

“Step 2: Add Credentials for the Data Domain System” on page 27 describes how to add 

credentials. 


To enable OST on the Data Domain system: 

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

# filesys status 

The file system is enabled and running. 


2. Add the OST license using the license key that Data Domain provided. For example: 

# license add ABCD-BCDA-CDAB-DABC 

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

3. Set the OST user by entering: 

# ost set user-name username 

OST user set to username 

Previous user: none set 

Notes This user’s username and password must have already been set up on the Data Domain 

system with the user add username [password password] command. 

Use the same username and password as in the NetBackup credentials for connecting to 

the Data Domain system. 

4. Enable Data Domain OST: 

# ost enable 

OST enabled 

The command creates and exports the /backup/ost directory. Only administrative users 

can use the command. 

Installing OST 21

Installing the Data Domain OST Plug-in 


This section describes installation tasks to perform on the NetBackup media server(s). Follow the 

instructions appropriate for your operating system. 

Note You can enter commands using the command line interface (CLI) on either the master or 

the media server. The advantage of entering CLI commands on the master server is that 

you know which master server is being updated. If you run commands from the master 

server, use the -media_server option to tell NBU where to direct the operation that 

queries the plug-in about the Data Domain storage server’s properties. 

UNIX Plug-in Installation 

To install and set up OST on a NetBackup media server: 

1. Stop the NetBackup nbrmms process: 

# nbrmms -terminate 

2. Install the OST plug-in. 

The plug-in is a set of libraries in a gtar package called OST. The package also contains a 

installation script called install.sh. 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 NetBackup normally looks for packages. The shared library files that the script 

installs are libstspiDataDomain.so and libstspiDataDomainMT.so. 

The plug-in recognizes DataDomain as the Data Domain vendor prefix. 


Windows Plug-in Installation 


You install the Data Domain NetBackup OpenStorage Plug-in using a Setup Wizard. The plug-in 

executable is either ddplugin32.msi or ddplug64.msi, depending on your Windows Server 

operating system. 

To install the Windows plug-in: 

1. Double-click the set-up executable to launch the Setup Wizard. 

2. Read the Welcome screen, and click Next. 

3. Select the installation folder. 

By default, the plug-in is installed in the C:\Program 

Files\Veritas\NetBackup\Bin\ost-plugins folder. If your copy of NetBackup 

is installed in different folder, click the Browse button and select that folder, or type the 

complete pathname of the NetBackup installation folder in the text box. For example, if 

Netbackup is installed in D:\Veritas\NetBackup, select or type the path as 

D:\Veritas\NetBackup\Bin\ost-plugins. 

4. Click Disk Cost to determine how much disk space the plug-in consumes. 

Installing OST 23


5. Select whether you want to restrict the plug-in so that only you (the installer) can use it, or if 

you want to make it available to anyone who uses the computer. Click Next. 

6. In the Confirm Installation screen, click Next to start the installation. 

A progress bar shows the status of the installation. 

7. After the installation is complete, the Installation Complete screen is displayed. Click Close. 


OST Configuration 4 

This chapter explains how to configure the Data Domain system and the NetBackup media server 

for Data Domain OST. 

Configuring the Data Domain System 

This section explains how to create LSU for each Data Domain system enabled for OpenStorage. 

About Naming the Data Domain OST Server 

NetBackup uses unique names to distinguish among storage servers; therefore, every Data Domain 

system that is enabled for OpenStorage must have a unique name. 

Tip You can use the Data Domain system’s DNS name, which is sure to be unique. To confirm to 

NetBackup naming conventions, use only alphanumeric characters. After the first character, 

you can use the period, hyphen, and underscore characters. 

Create Logical Storage Units (LSUs) 

LSUs on the Data Domain system correspond to disk pools on the NetBackup media server. You 

can create or delete LSUs only through the Data Domain command line interface (CLI). Each LSU 

is a top-level subdirectory of the /backup/ost directory. There is no hierarchy among LSUs. 

Important For this release, there must be one and only one LSU per Data Domain system. 

Use the ost lsu command on the Data Domain system to create an LSU. For example: 

# ost lsu create lsu1 

Caution When naming LSUs, be sure to assign each a unique name to avoid confusion. 

Repeat the procedure for each OST-enabled Data Domain system. 

25

Configuring the NetBackup Media Server 


This section explains how to configure the NetBackup system. 

Caution When naming disk pools, storage units, and lifecycle policies, be sure to assign each a 

unique name to avoid confusion. 

Note You can use either a static IP address or a hostname as the storage_server parameter. 

The hostname is resolved using the DNS lookup table on the NetBackup media server. The 

IP address bypasses this table. When you use a hostname, any data sent to the storage server 

uses the resolved address. The following examples use a DNS hostname (dd22) rather than a 

static IP address. 

Step 1: Register the Data Domain OST Server 

Use the name you assigned to the Data Domain OST server to register the server with the 

NetBackup media server and the Data Domain OST plug-in that resides on the media server. 

Repeat the procedure for each Data Domain system enabled for Data Domain OST. 

Enter the following command from the media server for each Data Domain storage server to be 

registered: 

Note In the following command examples, the storage_server parameter can be either an 

IP address or a DNS name. A DNS name is shown in the examples. 

# nbdevconfig 

-creatests 

-storage_server dd22 

-stype DataDomain 

-media_server load64 

In this example, the name of the Data Domain OST server is dd22. 

Tip If registering the name fails, look at the NBU 6.5 config log for error messages that 

occurred in the last 20 minutes: 

# vxlogview -n 1 -i 222 

-t 00:10:00 | grep DataDomain 

If the create fails, look for error messages entered into the NBU 6.5 configuration log within the 

last 20 minutes, using this command: 

# vxlogview -n 1 -i 222 

-t 00:20:00 | grep DataDomain 



Step 2: Add Credentials for the Data Domain System 

When you add the credentials, NetBackup: 

• Saves the credentials so the media server can log onto the storage server. 

• Configures the media server as a data mover. A data mover is an entity that moves data 

between the primary storage (the NetBackup client) and the storage server. 

NetBackup does not monitor connectivity between data movers and storage servers. However, 

when you add the credentials on each media server, NetBackup configures and maintains an access 

path between the media server and the storage server. 

Add credentials for each registered Data Domain storage server with which this media server needs 

to communicate using the tpconfig command: 

Important Run the tpconfig command on each media server that needs to access a Data 

Domain storage server. 

# tpconfig 

-add -storage_server dd22 

-stype DataDomain 

-sts_user_id username 

-password password 

If the add credentials operation fails, do the following: 

1. Look for authentication messages in the ddfs.info file on the Data Domain system. 

2. Ensure that the username and password match the ones on the Data Domain system. 

Use the ost show user-name command on the Data Domain system to check the 

username. 

3. To change the username and password, enter a command line such as this: 

# tpconfig -update 

-storage_server dd22 

-stype DataDomain -sts_user_id username 


4. Restart the nbrmms process: 

# nbrmms 

OST Configuration 27


Step 3: Create Disk Pools 

Disk pools are collections of disk volumes that NetBackup administers as single entities. 

In Data Domain OST, disk pools correspond to Logical Storage Units (LSUs). Repeat the 

following procedure for each Data Domain system enabled for OpenStorage. NetBackup provides 

both a command line interface (CLI) and a graphic user interface (GUI). You can use either to 

create disk pools. 

Note Names for disk pools should be unique. 

To use the NetBackup CLI the create a disk pool: 

Enter commands similar to the following: 

# nbdevconfig -previewdv 

-storage_server dd22 -stype DataDomain 

> /tmp/dvlist 

# nbdevconfig -createdp 

-dp dd22_lsu1_dp -stype DataDomain 

-storage_servers dd22 

-dvlist /tmp/dvlist 

The following output is displayed: 

Disk pool dd22_lsu1_dp has been successfully created with 1 

volume. 

The first command obtains the identity of the LSU on the Data Domain system called dd22. The 

second command uses the information to create a disk pool called dd22_lsu1_dp. 


To use the NetBackup GUI to create disk pools: 

1. Open the administration console’s Devices window. 


2. In left pane right-click Media and Device Management > Devices > Disk Pools, and select New 

Disk Pool from the context menu. 

The Disk Pool Configuration Wizard’s Select Storage Server window is displayed. 

dd22 

dd23 

3. Select the desired storage server (for example, dd22) and click Next. 



The Disk Pool Configuration Wizard’s Select Volumes window is displayed. 

4. Select the desired LSU and click Next. 

The Disk Pool Configuration Wizard’s Disk Pool Properties window is displayed. 

dd22 

dd22 

dd22 

5. Enter a unique name for the disk pool, such as dd22_lsu1_dp, in the Disk Pool Name field and 

click Next. 

6. You are presented with the option of creating a storage unit, which opens the GUI for creating 

storage units. 


Step 4: Create Storage Units 


Storage units on the NetBackup media server are collections of disk pools. NetBackup provides 


create storage units. 

To use the NetBackup CLI to create storage units: 

Enter a command similar to the following: 

# bpstuadd 

-label dd22_lsu1_su -dp dd22_lsu1_dp 

-host load64a 

-M load64a 

To use the NetBackup GUI to create storage units: 

1. Open the administration console’s Storage window. 

2. In the left pane, right-click NetBackup Management > Storage > Storage Units, and select New 

Storage Unit from the context menu. 

The New Storage Unit window is displayed. 



dd22 

dd22 

dd22 

3. Enter a name for the new storage unit. 

4. Set Storage Unit Type to Disk and Disk Type to OpenStorage (DataDomain). 

5. Select the desired disk pool from the Disk Pool list. 

6. Select which media server(s) can access this storage unit. 

If a storage unit needs to be visible to a select set of media servers, you can select (check) the 

name of each in the list. 

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

Click Next. 

About OST Storage Units 

Only the media servers on which storage server credentials are configured appear in the Media 

Servers list. If a server does not appear, verify that the Data Domain OST plug-in is installed and 

that logon credentials are configured for that media server. 

Note Run the tpconfig command-line utility directly on the media server to configure and 

verify credentials. 

NetBackup selects a media server when the policy runs. Media servers are configured as data 

movers when the storage server logon credentials are entered in NetBackup. 


Step 5: Create a Backup Policy 


You can initiate backups manually whenever you like. Optionally, you can set up a backup policy, 

which initiates backups automatically according to the conditions you specify. NetBackup provides 


create a back up policy. 

To use the NetBackup CLI, enter commands similar to the following: 

# bppolicynew mypolicy 

# bpplinfo mypolicy 

-set -v -residence dd22_lsu1_su 

bpplinfo: INITIATING: version NetBackup 6.5 created: 2007072322 

bpplinfo: EXIT status = 0 

# bpplsched mypolicy 

-add Fullbackup -st FULL 

# /bpplclients mypolicy 

-add load64a Linux SuSE2.6 

# bpplinclude mypolicy 

-l -add /etc 

# bpplinclude mypolicy 

-l -add /home 

To use the NetBackup GUI to create a backup policy: 

1. Open the administration console’s Policies window. 



2. In the left pane, right-click NetBackup Management > Policies, and select New Policy from the 

context menu. 

The Change Policy window is displayed. 

dd22_to_dd23_lifecycle 

dd22_lsu1_su 

dd23_lsu1_su 

dd22_to_dd23_lifecycle 

3. Set up policies, following these guidelines: 

- Do not select compression. 

- Select the desired lifecycle policy from the Policy storage list. (The icons for storage unit 

and lifecycle policy are different). 


Configuring Optimized Duplication 5 

This chapter explains how to configure the optimized duplication feature. 

The Data Domain OST plug-in enables a NetBackup media server to specify a duplication process 

and delegate execution of it to the Data Domain system. The sharing of the process has the 

following advantages: 

• The NetBackup system retains control of creating and duplicating backup images. NetBackup 

keeps track of all copies in its catalog, which ensures easy and efficient recovery. 

• You can use optimized duplication as well as directory and collection replication on the same 

Data Domain system. 

• Optimized duplication removes the NetBackup media server from the process of creating 

duplicates of backup images, which reduces the load on the NetBackup system, and frees it for 

other work. 

• The Data Domain system uses its efficient replication process for deduplicated data. The 

process is optimized for Wide Area Networks (WANs), thereby reducing overall load on the 

WAN. 

Note Limitations of Optimized Duplication. If an optimized duplication operation fails, 

NetBackup reverts to performing the duplication itself, using its usual duplication process. 

The scheduled duplication job then takes place, but loses the benefit of the Data Domain 

system’s optimized transfer of deduplicated data. 

Tip If there is a preferred link or IP address for sending the optimized duplication data between 

two Data Domain storage servers, use that link/address when creating the destination storage 

server. 

You can initiate optimized duplication manually at any time by using the bpduplicate 

command. There are several ways to establish automatic replication schedules. Instructions on how 

to set up a storage lifecycle policy to use optimized duplication follow. 

35

A storage lifecycle policy is a list of destinations for backup images and a retention period for each 

image. A lifecycle process creates, retains, and finally destroys the images. An advantage of using 

storage lifecycle policies is that you can specify different retention periods for the initial backup 

and for the duplicate. For example, you might specify different retention periods for a duplicate at a 

disaster recovery site and for the original local backup. 

The example in the following procedure creates a lifecycle policy that first backs up to an 

OST-enabled Data Domain system and then creates a duplicate copy on another OST-enabled Data 

Domain system. The first storage destination is of type Backup to the first OST-enabled Data 

Domain system. The second storage destination is of type Duplication to the second OST-enabled 

Data Domain system. 

To use the NetBackup GUI to create a storage lifecycle: 

1. Open the administration console’s Storage window. 


2. In left pane go to NetBackup Management > Storage. Right-click Storage Lifecycle Policies. 

Select New Storage Lifecycle Policy from the context menu. 

The New Storage Lifecycle Policy window is displayed. 

3. Click Add to specify a destination for backup. 

The New Destination window is displayed. 

dd22_lsu1_su 

4. Click Add to specify a destination for duplicate. 

The New Destination window is displayed. 

Configuring Optimized Duplication 37

dd23_lsu1_su 

5. Set up the storage lifecycle policy. Select either Backup or Duplication. 

6. Select the storage unit from the list. 

7. Select one of the supported retention types. 

- Fixed 

Fixed means to retain for a specific period of time. Then NetBackup deletes information 

about the expired backup, and the files in the backup become unavailable to restore 

operations. Fixed retention enables you to use different retention periods for backup 

copies on local and remote OpenStorage servers. For example, you can 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. 

- Expire after duplication 

Applies only to backup destinations, not 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 

Note Currently, the staged capacity-managed retention option is not supported. 


OST Commands 6 

This chapter describes the command line interface (CLI) that manages the OST feature on the Data 

Domain system. 

The ost command allows you to create and delete logical storage units (LSUs) on the storage 

server and to display how LSUs use disk space. The LSUs and their contents remain in the Data 

Domain file system even if you subsequently disable OST. Once you re-enable OST, you can use 

the LSUs again. 

Caution You can destroy all LSUs and their contents by using the ost destroy command. 

The command requires a sysadmin password. 

An OpenStorage connection between a plug-in and Data Domain system requires authentication. 

When enabling OpenStorage on the Data Domain system, you must supply a user name. Use the 

user add command to create a user. The Data Domain system uses the username and password 

to create the OST LSUs and images. 

Note For performance reasons, the Data Domain system limits the number of active connections 

to 32. 

Adding the OST License 

An administrative user can add the OST license: 

# license add license-code 

The code for each license is a string of 16 letters with dashes. Include the dashes when entering the 

license code. For example: 

# license add ABCD-BCDA-CDAB-DABC 

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

39

Adding an OST User 

Adding an OST User 

An OST user is added to a Data Domain system in the same way as any other user. OST users 

should be added as administrative users. 

Use the user add user-name operation. The operation asks for a password and confirmation, 

or you can include the password as part of the command. Each user has a privilege level of either 

admin (the default) or user. To change a user’s privilege level, you must delete the user and then 

add the user with the other privilege level. 

Note The user add command is available to administrative users only. 

A user name must start with an alpha character. 

user add user-name [password password][priv {admin | user}] 

Note The user names root and test are default existing names on every Data Domain system 

and are not available for general use. Use the existing sysadmin user account for 

administrative tasks. 

For example, to add a user with a logon name of jsmith, a password of usr256, and administrative 

privilege, enter: 

# user add jsmith password usr256 priv 

Setting the OST User 

To set the OST user, use the ost set user-name command. You can execute the command 

while OST is enabled. For example: 

# ost set user-name ost 

OST user set to ost. Previous user: none set 

Note NetBackup uses the user’s credentials to connect to the Data Domain system. You must add 

the credentials to each NetBackup media server that connects to this Data Domain system. 

Refer to the “OpenStorage” chapter in the NetBackup Shared Storage Guide for this step. 


Reverting to No OST User 

Reverting to No OST User 

To remove the OST user setting so that there is no OST user, use the ost reset user-name 

command. You can execute the command while Data Domain OST is enabled. For example: 

# ost reset user-name 

OST user set to none. Previous user: ost 

Displaying the OST User 

Enabling OST 

To show the current OST user, enter the ost show user-name command: 

# ost show user-name 

OST user: ost 

Note The command requires an existing OST user. 

An administrative user can use the ost enable command to create and export the 

/backup/ost directory. For example: 

# ost enable 

OST enabled. 

If the user changes, the change takes effect at the next ost enable command. 

If the UID and GID change, the Data Domain system updates all images and LSUs at the next ost 

enable command. 

Disabling OST 

An administrative user can disable OST for the Data Domain system: 

# ost disable 

Is OST Is Enabled or Disabled? 

Use the ost status operation to see whether OST is enabled or disabled. For example: 

# ost status 

OST status: enabled 

OST Commands 41

Creating an LSU 

Creating an LSU 

An administrative user can use the ost lsu create operation to create an LSU with a given 

name. 

# ost lsu create lsu-name 

After issuing the filesys destroy command, you need to run ost disable followed by 

ost enable and then create an LUS using the ost lsu create command. If you do not 

run these commands, the Data Domain system reports an error. 

Deleting an LSU 

An administrative user can use the ost lsu delete operation to delete a specified LSU and 

all of its contents. For example, to empty the LSU lsu66 of all its contents: 

# ost lsu delete lsu66 

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

Deleting all LSUs 

An administrative user can delete all LSUs and their contents from the Data Domain system. You 

must also manually remove (expire) the corresponding NetBackup catalog entries. Enter: 

# ost destroy 

Note The command permanently removes all of the data (images) contained in the LSUs. 

Displaying LSU Names 

Use the ost lsu show command to display the names of all LSUs or, optionally, the names of 

all images in a specified LSU. You can also request the original, globally compressed, and locally 

compressed sizes. Enter: 

# ost lsu show [compression] [lsu-name] 

Note To interrupt the output of this command, press Control-C. 


Examples: 

# ost lsu show 

List of LSUs: 

LSU 

LSU_NBU2 

LSU_NBU 

LSU_NBU1 

LSU_NBU2 

LSU_NBU3 

LSU_NBU_OPT_DUP 

LSU_NBU_ARCHIVE 

LSU_TM1 

TEST 

# ost lsu show LSU_NBU1 

Displaying LSU Names 

List of images in LSU_NBU1: 

zion.datadomain.com_1184350349_C1_HDR:1184350349:jp1_policy1:4:1:: 

zion.datadomain.com_1184350349_C1_F1:1184350349:jp1_policy1:4:1:: 

[ ... ] 

# ost lsu show compression 

List of LSUs and their compression info: 

LSU_NBU1: 

Total files: 4; bytes/storage_used: 206.6 

Original Bytes: 437,850,584 

Globally Compressed: 2,149,216 

Locally Compressed: 2,113,589 

Metadata: 6,124 

LSU_NBU2: 


Original Bytes: 69,198,492,217 



Metadata: 1,411,828 

[ ... ] 


Viewing OST Statistics 

# ost lsu show compression LSU_NBU1 

List of images in LSU_NBU1 and their compression info: 

zion.datadomain.com_1184350349_C1_HDR:1184350349:jp1_policy1:4:1::: 


Original Bytes: 8,872 

Globally Compressed: 8,872 

Locally Compressed: 738 

Metadata: 236 

zion.datadomain.com_1184350349_C1_F1:1184350349:jp1_policy1:4:1::: 


Original Bytes: 114,842,092 



Metadata: 382,576 

[ ... ] 


Use the ost show stats operation to view OST statistics for the Data Domain system. 

Note The ost show stats interval seconds command shows a different set of OST 

statistics. 

The ost show stats operation shows the following OST statistics for the Data Domain system 

since the last ost enable command: 

• Output of an earlier show stats command. 

• Number of bytes written to OST images contained in LSUs. 

• Number of bytes read from OST images contained in LSUs. 

• Number of OST images created in LSUs. 

• Number of OST images deleted from LSUs. 



The number in brackets at the end of each line is the number of errors encountered for that 

operation. For example: 

# ost show stats 

07/23 12:01:05 

OST statistics: 

OSTGETATTR: 4 [0] 

OSTLOOKUP: 13 [9] 

OSTACCESS: 0 [0] 

OSTREAD: 0 [0] 

OSTWRITE: 329 [0] 

OSTCREATE: 2 [0] 

OSTREMOVE: 0 [0] 

OSTREADDIR: 0 [0] 

OSTFSSTAT: 20 [0] 

FILECOPY_START: 0 [0] 

FILECOPY_ABORT: 0 [0] 

FILECOPY_STATUS: 0 [0] 

OSTQUERY: 11 [0] 

OSTGETPROPERTY: 14 [0] 

Count Errors 

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

Image creates 2 0 

Image deletes 0 0 

Total bytes written 10,756,096 0 

Total bytes read 0 0 

Other - 0 

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


Viewing OST Statistics over an Interval 

Viewing OST Statistics over an Interval 

Use the ost show stats interval operation to view various statistics over a specified time 

interval. The command displays the number of Kilobytes read and written over the interval. The 

format is as follows: 

ost show stats interval seconds 

Note The ost show stats command shows a different set of OST statistics. 

For example: 

# ost show stats interval 1 

07/23 12:03:35 

Write KB/s Read KB/s 

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

87,925 0 

69,474 0 

84,080 0 

76,410 0 

4,339 0 

2,380 0 

17,281 0 

21,854 0 

27,018 0 

26,682 0 

21,899 0 

11,667 0 

25,236 0 

21,898 0 

25,700 0 

12,972 0 

07/23 12:03:54 

Write KB/s Read KB/s 

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

15,796 0 

27,414 0 

27,893 0 

18,388 0 

3,245 0 

27,194 0 


Viewing OST Operation Latencies 

Viewing OST Operation Latencies 

The ost show histogram operation shows an OST histogram for the Data Domain System. 

ost show histogram 

The command displays the latencies of OST operations in the form of a histogram that you can use 

to analyze performance. 

For example: 

# ost show stats 

Operation mean-ms stddev max-s 10s 

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

OSTGETATTR 0.0 0.0 0.0 46 0 0 0 0 

OSTLOOKUP 0.1 0.0 0.0 88 0 0 0 0 

OSTACCESS 0.4 0.1 0.0 8 0 0 0 0 

OSTREAD 0.0 0.0 0.0 0 0 0 0 0 

OSTWRITE 0.0 0.0 0.0 0 0 0 0 0 

OSTCREATE 1.0 0.1 0.0 14 0 0 0 0 

OSTREMOVE 0.0 0.0 0.0 0 0 0 0 0 

OSTREADDIR 0.3 0.2 0.0 17 0 0 0 0 

OSTFSSTAT 0.0 0.0 0.0 5011 0 0 0 0 

FILECOPY_START 0.0 0.0 0.0 0 0 0 0 0 

FILECOPY_ABORT 0.0 0.0 0.0 0 0 0 0 0 

FILECOPY_STATUS 0.0 0.0 0.0 0 0 0 0 0 

OSTQUERY 0.0 0.0 0.0 2710 0 0 0 0 

OSTGETPROPERTY 0.8 3.9 0.2 2713 1 0 0 0 

Clearing OST Statistics 

An administrative user can reset all statistic via the ost reset stats commands. The 

command can be used while Data Domain OST is enabled. 

# ost reset stats 


Viewing OST Connections 

Viewing OST Connections 

Use the ost show connections command to display the maximum number of allowed 

connections and the list of current active connections. 

For example: 

# ost show connections 

Max connections: 32 

Active clients: 

--------------zion.company.com 

Displaying Statistics for Active Optimized Duplication 

Operations 

The ost show image-duplication active command shows the status of all the 

currently active inbound and outbound optimized duplication operations. 

# ost show image-duplication active 

The command displays the following information for any active operations: 

• Name of the file. 

• Total number of logical bytes to transfer. 

• Number of logical bytes already transferred. 

• Number of real bytes transferred. 

For example: 

# ost show image-duplication active 

07/24 18:11:54 

Inbound image name 


Logical bytes received 1,800,000 

Real bytes received 900,000 

Outbound image name 


Logical bytes to transfer 4,000,000 

Logical bytes already transferred 2,000,000 

Real bytes transferred 1,000,000 


Operation and Maintenance 7 

This chapter covers the following topics: 

• Uninstalling and upgrading the Data Domain OST plug-in 

• Deleting the Data Domain storage server 

• Grouping storage units to provide failover 

• Duplicating images using the NetBackup interface 

• Setting network time-outs on the NetBackup System 

Uninstalling the Data Domain OST Plug-in 

Follow the instructions for your operating system. 

• UNIX Plug-in Uninstall 

To uninstall the Data Domain OST plug-in from the NetBackup media server, remove the 

following files: 

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

/usr/openv/lib/ost-plugins/libstspiDataDomainMT.so 

• Windows Plug-in Uninstall 

To uninstall the Windows plug-in, go to Start > Control Panel > Add or Remove Programs. 

Select the plug-in and click Remove. 

After deleting the files, restart the NetBackup Remote Manager and Monitor Service (nbrmms). 

Note Uninstalling the OST plug-in does not unregister any storage servers registered on the media 

server. It does not delete the disk pools, storage units, or storage unit groups. The uninstall 

does not expire any backup images. 

See the NetBackup documentation for more information. 

49

Upgrading the OST Plug-in 

If you upgrade the Data Domain system to a version with increased OST functionality, you must 

also upgrade the OST plug-in. NetBackup does not keep track of the functionality that each plug-in 

supports. You must perform the upgrade manually. 

Follow the instructions for your operating system. 

UNIX 

Upgrading the Data Domain OST UNIX plug-in overwrites the previous installation. 

To upgrade the UNIX plug-in: 

1. Follow the instructions given in “Installing the Data Domain OST Plug-in” on page 22. 

2. Restart the NetBackup Remote Manager and Monitor Service (nbrmms). 

Windows 

To upgrade to a later version of the OST Windows plug-in: 

1. Uninstall the plug-in and then re-install the latest version as described in “Windows Plug-in 

Installation” on page 23. 

Restart the NetBackup Remote Manager and Monitor Service (nbrmms). 


Deleting the 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. 

To delete the Data Domain storage server: 

1. Delete all of the images specified by the BACKUP_ID: 

# bpexpdate -backupid BACKUP_ID -d 0 

2. Delete all of the policies from the GUI. 

3. Delete all of the storage units: 

# bpstudel -label SU_NAME 

4. Delete all the disk pools: 

# nbdevconfig -deletedp -stype DataDomain -dp POOL_NAME 

5. Delete the storage server: 

# nbdevconfig -deletests -storage_server DDR -stype DataDomain 

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

For troubleshooting information, see “If You Cannot Delete the Data Domain Server” on page 58. 

6. Remove credential using the tpconfig command. 

# tpconfig -update 

-storage_server dd22 -stype DataDomain 

-sts_user_id username 


Grouping Storage Units to Provide Failover 

Groups of disk pools are storage units. A NetBackup administrator can identify a group of storage 

units to share a workload. The administrator tells the NetBackup system how to choose among the 

storage units in the group for the next job. The administrator sets one of the following selection 

criteria: 

• Prioritized 

• Round robin 

Operation and Maintenance 51

• Load balance 

• Failover 

Setting failover as the selection criterion ensures that a backup job does not fail if the storage unit to 

which it is directed fails. NetBackup chooses another storage unit in the same group to finish the 

job. 

Tip When grouping Data Domain OST storage units on the NetBackup media server, set the 

selection criterion to failover. 

Duplicating Images (NBU Workaround) 

When using the NetBackup graphical user interface to duplicate images, be sure to select Media ID 

in the Search for images panel of the Search tab. 

Setting Network Time-outs on the NetBackup System 

Backup and restore jobs often take a long time to complete. The OST plug-in can recover from 

temporary network interruptions, but the operating system on the NetBackup system might 

terminate the job prematurely if NetBackup time-outs are set too low. 


Data Domain recommends setting time-outs to at least 30 minutes. You can do this by adding the 

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

CLIENT_CONNECT_TIMEOUT = 30 

CLIENT_READ_TIMEOUT = 30 

Alternatively, you can use the NetBackup graphical user interface (GUI) to change the settings. 

To change NetBackup time-out settings 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. A property window is displayed. 

5. Change the time-out values in the property window. 

Operation and Maintenance 53


Troubleshooting 8 

This chapter addresses troubleshooting for the Data Domain system and the NetBackup 

environment. 

General Troubleshooting 

When investigating problems be aware that the Data Domain OST has components on both a Data 

Domain system and a NetBackup system. The two environments must be compatible. 

Troubleshooting considerations that apply to both systems follow: 

• Supported Configurations 

Ensure that you have a supported configuration. See “Supported Configurations” on page 15. 

A supported configuration can become unsupported if any of the components changes. 

• Authorization Failures 

If you encounter authorization failures, ensure that all of the systems have correct access 

credentials for the other systems. “Installing OST” on page 19 provides instructions on 

establishing the necessary user credentials and gives tips for diagnosing and correcting access 

problems. 

• List of Credentials 

From the NetBackup system, use the following command to obtain a list of credentials for all 

Data Domain systems registered as storage servers: 

# tpconfig -dsh 

-all_hosts -stype DataDomain 

55

Troubleshooting the Data Domain System 


Some of the Data Domain CLI commands can assist you with troubleshooting. 

Show Status 

The chapter “OST Commands” on page 39 describes command usage. For example, if a backup 

fails, the ost show stats command might display this output: 

07/23 12:01:05 

OST statistics: 

OSTGETATTR: 4 [0] 

OSTLOOKUP: 13 [9] 

OSTACCESS: 0 [0] 

OSTREAD: 0 [0] 

OSTWRITE: 329 [0] 

OSTCREATE: 2 [0] 

OSTREMOVE: 0 [0] 

OSTREADDIR: 0 [0] 

OSTFSSTAT: 20 [0] 

FILECOPY_START: 0 [0] 

FILECOPY_ABORT: 0 [0] 

FILECOPY_STATUS: 0 [0] 

OSTQUERY: 11 [0] 

OSTGETPROPERTY: 14 [0] 

Count Errors 

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

Image creates 2 1 

Image deletes 0 0 

Total bytes written 10,756,096 0 

Total bytes read 0 0 

Other - 0 

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


Data Domain Log File 


The main log file on the Data Domain system is ddfs.info. The contents of the file for a 

successful backup might resemble the following: 

06/12 11:42:04.849 (tid 1598232928): mountproc3_mnt_3_svc from 

192.168.11.40 succeeded for export point /backup/ost 

06/12 11:42:04.851 (tid 1577253216): svc_req_create max_num_req=3 

06/12 11:42:04.853 (tid 1598232928): OST properties: active_conns =1 

max_conns =32 

06/12 11:42:06.856 (tid 1598232928): mountproc3_umnt_3_svc called from 

(192.168.11.40), export point /backup/ost 








06/12 11:42:08.925 (tid 1598232928): OST verify user: OK user ost uid 

500 gid 50 

06/12 11:42:08.925 (tid 1598232928): mountproc3_ost_mnt_3_svc: 

connection request from plugin 192.168.11.40 version 9.4 




06/12 11:42:09.050 (tid 1598232928): 

sfs_create("ost/LSU_NBU1/zion.company.com_1181673602_C1_HDR:1181673602 

:jp1_policy1:4:1::", 0x88000042, 0x1a) 

06/12 11:42:09.055 (tid 1598232928): 

sfs_create("ost/LSU_NBU1/zion.company.com_1181673602_C1_F1:1181673602: 

jp1_policy1:4:1::", 0x88000042, 0x1a) 

06/12 11:42:09.482 (tid 1598232928): OST properties: active_conns =1 

max_conns =32 



Troubleshooting 57


If You Cannot Delete the Data Domain Server 

If your attempt to delete the Data Domain Storage server using -deletests fails, the emm or 

rmms process might be down. 

# nbdevconfig -deletests -storage_server DDR -stype DataDomain 

Note If there are core files, contact Data Domain Support. 

If rmms restarts, but emm does not, verify that all of the processes are up, especially emm or rmms. 

If they are not up, run this command: 

# /bp/bin/goodies/netbackup start 

If the deletests still fails, enable more NBU logging. Follow these steps: 

1. Open the /bp/nblog.conf file and add this entry: 

NBSTSI=OID=202 

2. Enable detailed logging messages as described in “Error Logging” on page 61. 


Troubleshooting the NetBackup Environment 

Suggestions for troubleshooting the NetBackup environment follow. 

Checking the Installation 


Problems with basic operations such as backups may result from improper installation. The plug-in 

consists of the following shared library files, depending on your operating system: 

• UNIX 

- libstspiDataDomain.so 

- libstspiDataDomainMT.so 

To verify that the files are in the correct location, enter: 

# ls /usr/openv/lib/ost-plugins/ 

The command output should be the names of the shared library files. 

• Windows 

- libstspiDataDomain.dll 

- libstspiDataDomainMT.dll 

To verify that the files are in the correct location, enter: 

# C:\Program Files\Veritas\bin\ost-plugins 

The command output should be the names of the shared library files. 

To determine the plug-in version, enter: 

# bpstsinfo -pi 

The command output depends on your operating system: 

UNIX 

Plugin Name: libstspiDataDomainMT.so 






Vendor Version: 1.1.0.0 

Troubleshooting 59


Windows 

Plugin Name: libstspiDataDomainMT.dll 






Vendor Version: 1.1.0.0 

where: 

Vendor Version is the plug-in version, and Build Version is the version of the OST API. 

Checking Credentials 

If you receive a message stating that you failed to add credentials for the DataDomain 

OpenStorage server, perform the “Step 2: Add Credentials for the Data Domain System” on 

page 27. The procedure shows how to set up credentials and how to check for errors and 

inconsistencies. 

Configuration Problems 

The chapter “OST Configuration” on page 25 contains information about creating disk pools and 

storage units on the NetBackup media server. If the Configure Disk Pool wizard reports a license 

error, check to see whether the bp.conf file contains an extra CLIENT_NAME entry. An extra 

entry can happen after a NetBackup upgrade from version 6.0 to 6.5. 


Error Logging 


The principal tool for troubleshooting problems on the NetBackup side with the Data Domain OST 

plug-in is the error log. Before starting a backup, restore, or optimized duplication operation, run 

the following script on the NetBackup media server to enable logging. The script depends on your 

operating system: 

UNIX 

# /usr/openv/netbackup/logs/mklogdir 

Windows 

C:\Program Files\Netbackup\logs\mklogdir.bat 

Data Domain System 

Alternatively, you can enable logging from the GUI. 

To enable logging: 

1. Expand the NetBackup Management node. 

2. Expand Host Properties. 

3. Select Master Servers. 

4. In the right pane, double-click the machine name. The property window is displayed. 

5. Select a logging node from the tree pane. 

6. Set the global logging level to 5, and click OK. 

Once you have enabled logging, the OST plug-in prefixes error and informational log messages by 

the name of the plug-in: DataDomain. 

Troubleshooting 61


Failed Backups 

If a backup operation fails, look for plug-in error messages in the log file. Enter the appropriate 

command line for your operating system. 

UNIX 

# cat /usr/openv/netbackup/logs/bptm/LOGFILE_DATE | 

grep DataDomain 

The command selects from the specified log file lines that contain the word DataDomain, 

which the plug-in uses as a prefix for its log messages. 

Windows 

C:\Program Files\Veritas\logs\bptm\LOGFILE_DATE.log 

Open the file and search for DataDomain. 


You can also use the ost show stats command on the Data Domain system to check for errors 

(see “Viewing OST Statistics” on page 44). 

Another source of information on the Data Domain system is the ddfs.info file. Look for OST 

error messages, or for messages that begin with filecopy. 


Failed Image Duplication 


Look for plug-in error messages in the following log files, depending on your operating system: 

UNIX 

For read_image: 

/usr/openv/netbackup/logs/bpdm 

For write_image: 

/usr/openv/netbackup/logs/bptm 

For opt-dup: 

/usr/openv/netbackup/logs/bpdm 

Windows 

For read_image: 

C:\Program Files\Veritas\logs\bpdm 

For write_image: 

C:\Program Files\Veritas\logs\bptm 

For opt-dup: 

C:\Program Files\Veritas\logs\bpdm 


On the Data Domain system, look for OST or filecopy error messages in the ddfs.info file. 

To verify that the replication license is installed, enter the Data Domain license show 

command 

Plug-in Log Messages 

When the plug-in encounters an error, it returns an EPLUGIN error code to NetBackup and logs a 

reason for the error. 

Troubleshooting 63


Timed Out 

If you receive a time-out error, follow these steps: 

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: 


Program Not Registered 

The following error output indicates a not registered error. 

/usr/openv/netbackup/logs/bptm/log.082807:12:44:33.581 [2935] 

jp1: /usr/openv/lib/ost-plugins/libstspiDataDomain.so: 

stspi_write_image STS_EPLUGIN --> Can't connect to NFS server on jp1 

(: RPC: Program not registered) 

/usr/openv/netbackup/logs/bptm/log.082807:12:44:33.644 [2935] 

jp1: /usr/openv/lib/ost-plugins/libstspiDataDomain.so: 

stspi_get_image_prop STS_EPLUGIN --> async writeback or commit failure 

To investigate the not registered error: 

Verify that the file system is running on the Data Domain system: 



Cannot Connect on Socket 


If you run the command nbdevconfig -creatests and this error is displayed: 

$ nbdevconfig -creatests -storage_server dd22 -stype 

DataDomain -media_server load64 

Failed to create storage server dd22, cannot connect on socket 

Do the following: 

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. Examine the logs under /usr/openv/logs/51216-*.log with the vxlogview utility 

to check if there are any error indications. 

To correct the problem, you can drop and recreate the database by entering: 

$ /usr/openv/db/bin/create_nbdb -drop 

Troubleshooting 65

Data Domain OST User Guide - Symantec

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?