ndmp administration guid

7/31/2019 NDMP Administration Guid

1/104

VERITAS NetBackup 6.0 for

NDMP

System Administrators Guide

for UNIX, Windows, and Linux

N15271C

September 2005


2/104

Disclaimer

The information contained in this publication is subject to change without notice. VERITAS Software

Corporation makes no warranty of any kind with regard to this manual, including, but not limited to,the implied warranties of merchantability and fitness for a particular purpose. VERITAS SoftwareCorporation shall not be liable for errors contained herein or for incidental or consequential damagesin connection with the furnishing, performance, or use of this manual.

VERITAS Legal Notice

Copyright 2002 - 2005 VERITAS Software Corporation. All rights reserved. VERITAS, the VERITAS

Logo, and NetBackup are trademarks or registered trademarks of VERITAS Software Corporation orits affiliates in the U.S. and other countries. Other names may be trademarks of their respectiveowners.

Portions of this software are derived from the RSA Data Security, Inc. MD5 Message-DigestAlgorithm. Copyright 1991-92, RSA Data Security, Inc. Created 1991. All rights reserved.

VERITAS Software Corporation350 Ellis Street

Mountain View, CA 94043USAPhone 650-527-8000Fax 650-527-2908www.veritas.com

Third-Party Copyrights

For a list of third-party copyrights, see the NetBackup Release Notes appendix.

ii NetBackup for NDMP System Administrators Guide


3/104

Contents

Getting Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .vii

Finding NetBackup Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .vii

Accessing the VERITAS Technical Support Web Site . . . . . . . . . . . . . . . . . . . . . . . . viii

Contacting VERITAS Licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix

Accessibility Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix

Comment on the Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x

NetBackup for NDMP Information on the Web . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x

Advanced Client Information on the Web . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .x

Chapter 1. Introduction to NetBackup for NDMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1

NetBackup for NDMP Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

NetBackup for NDMP Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4Network Data Management Protocol (NDMP) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Types of NDMP Backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

NDMP Local Backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

NDMP Three-Way Backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Backup to Media Manager Storage Devices (Remote NDMP) . . . . . . . . . . . . . . . . . . 9

NDMP Policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Storage Units . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

NDMP Storage Units . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Media Manager Storage Units . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Assigning Tape Drives to Different Hosts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

NDMP Backup Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

NDMP Restore Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

iii


4/104

Direct Access Recovery (DAR) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Chapter 2. Installing NetBackup for NDMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Installation Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Installing on UNIX Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Installing on Windows Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Uninstalling NetBackup for NDMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Chapter 3. Configuring NDMP Backup to NDMP-Attached Devices . . . . . . . . . . . . 23

Authorizing Access to the NDMP Host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Access for Three-Way Backups and NDMP to Media Manager . . . . . . . . . . . . . . . 27

Media Manager Device Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Adding a Robot Directly Attached to an NDMP Host . . . . . . . . . . . . . . . . . . . . . . . 28

Adding a Drive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Checking a Media Manager Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Adding Volumes to a Media Manager Configuration . . . . . . . . . . . . . . . . . . . . . 33

Verifying NDMP Password and/or Robot Connection . . . . . . . . . . . . . . . . . . . . . . . . . 34

Adding NDMP Storage Units . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Creating an NDMP Policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Clients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

Schedules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

Using Environment Variables in Backup Selections list . . . . . . . . . . . . . . . . . . . 38

Enabling/Disabling DAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

Setting Up Clustering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

Post-Installation Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

Testing an NDMP Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

Chapter 4. Configuring NDMP Backup to NetBackup Media Servers . . . . . . . . . . . 45

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

iv NetBackup for NDMP System Administrators Guide


5/104

Configuring NDMP Backup to Media Manager Devices . . . . . . . . . . . . . . . . . . . . . . . . 47

Chapter 5. Using The Shared Storage Option (SSO) . . . . . . . . . . . . . . . . . . . . . . . . .49

Shared Storage Option (SSO): Basic Diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

Setting up SSO: Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

Using the Device Configuration Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

Chapter 6. Backup and Restore Procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .55

Performing an NDMP Backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

Automatic Backup of an NDMP Policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

Manual Backup of an NDMP Policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

Performing a Restore from the Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

Chapter 7. Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .59NDMP Operating Notes and Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

Notes on DAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

Troubleshooting NetBackup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

Types of Logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

Troubleshooting Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

NDMP Backup Levels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

Troubleshooting Media Manager on Windows Systems . . . . . . . . . . . . . . . . . . . . . . . . . 63

Troubleshooting Media Manager on UNIX systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

Troubleshooting DAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

Testing a Robot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

Chapter 8. Using Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

ndmp_start_notify (UNIX) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

ndmp_start_notify.cmd (Microsoft Windows) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

ndmp_end_notify (UNIX) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

ndmp_end_notify.cmd (Microsoft Windows) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76ndmp_start_path_notify (UNIX) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

Contents v


6/104

ndmp_start_path_notify.cmd (Microsoft Windows) . . . . . . . . . . . . . . . . . . . . . . . . . 80

ndmp_end_path_notify (UNIX) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

ndmp_end_path_notify.cmd (Microsoft Windows) . . . . . . . . . . . . . . . . . . . . . . . . . 84

ndmp_moving_path_notify (UNIX) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

ndmp_moving_path_notify.cmd (Microsoft Windows) . . . . . . . . . . . . . . . . . . . . . . 88

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

vi NetBackup for NDMP System Administrators Guide


7/104

Preface

This guide explains how to install, configure, and use VERITAS NetBackup for NDMP(Network Data Management Protocol). In this guide, VERITAS NetBackup is referred toas NetBackup.

This guide is intended for the system administrator responsible for installing, configuring,and using NetBackup for NDMP, and assumes a thorough working knowledge of how toadminister both NetBackup and the NDMP host platform.

Getting Help

You can find answers to questions and get help from the NetBackup documentation andfrom the VERITAS technical support web site.

Finding NetBackup Documentation

A list of the entire NetBackup documentation set appears as an appendix in the NetBackupRelease Notes. All NetBackup documents are included in PDF format on the NetBackupDocumentation CD.

For definitions of NetBackup terms, consult the online glossary.

To access the NetBackup online glossary1. In the NetBackup Administration Console, click Help > Help Topics.

2. Click the Contents tab.

3. Click Glossary of NetBackup Terms.

Use the scroll function to navigate through the glossary.

vii


8/104

Getting Help

Accessing the VERITAS Technical Support Web Site

The address for the VERITAS Technical Support Web site is http://support.veritas.com.

The VERITAS Support Web site lets you do any of the following:

Obtain updated information about NetBackup, including system requirements,supported platforms, and supported peripherals

Contact the VERITAS Technical Support staff and post questions to them Get the latest patches, upgrades, and utilities View the NetBackup Frequently Asked Questions (FAQ) page Search the knowledge base for answers to technical support questions Receive automatic notice of product updates Find out about NetBackup training Read current white papers related to NetBackupFrom http://support.veritas.com, you can complete various tasks to obtain specific typesof support for NetBackup:

1. Subscribe to the VERITAS Email notification service to be informed of software alerts,newly published documentation, Beta programs, and other services.

a. From the main http://support.veritas.com page, select a product family and aproduct.

b. Under Support Resources, click Email Notifications.

Your customer profile ensures you receive the latest VERITAS technicalinformation pertaining to your specific interests.

2. Locate the telephone support directory at http://support.veritas.com by clicking thePhone Support icon. A page appears that contains VERITAS support numbers fromaround the world.

Note Telephone support for NetBackup is only available with a valid supportcontract. To contact VERITAS for technical support, dial the appropriate phonenumber listed on the Technical Support Guide included in the product box andhave your product license information ready for quick navigation to the propersupport group.

3. Contact technical support using e-mail.

viii NetBackup for NDMP System Administrators Guide
http://support.veritas.com/http://support.veritas.com/http://support.veritas.com/http://support.veritas.com/http://support.veritas.com/http://support.veritas.com/http://support.veritas.com/http://support.veritas.com/


9/104


10/104

Comment on the Documentation

Comment on the Documentation

Let us know what you like and dislike about the documentation. Were you able to find theinformation you needed quickly? Was the information clearly presented? You can reporterrors and omissions or tell us what you would find useful in future versions of ourmanuals and online help.

Please include the following information with your comment:

The title and product version of the manual on which you are commenting The topic (if relevant) on which you are commenting Your comment Your nameEmail your comment to [email protected].

Please only use this address to comment on product documentation. See Getting Helpin this preface for information on how to contact Technical Support about our software.

We appreciate your feedback.

NetBackup for NDMP Information on the WebThe VERITAS support web site has a pdf document about supported NDMP operatingsystems and NAS vendors. It also contains configuration and troubleshooting help forparticular NAS systems.

Go to www.support.veritas.com and enter NAS Appliance in the search field. The titleof the document is: NetBackup for NDMP Supported OS and NAS Appliance Information.

Advanced Client Information on the Web

The VERITAS support web site has a pdf document about Advanced Client containing a

list of NAS vendors currently supported for the NAS_Snapshot method and forSnapVault, along with configuration notes.

Go to www.support.veritas.com and enter Advanced client configuration in the searchfield. The title of the document is: VERITAS NetBackup Advanced Client Configuration andCompatibility.

x NetBackup for NDMP System Administrators Guide
http:///reader/full/[email protected]:///reader/full/[email protected]


11/104

1Introduction to NetBackup for NDMP

NetBackup for NDMP is an optional application that enables NetBackup to use theNetwork Data Management Protocol (NDMP) to initialize and control backups andrestores of Network Attached Storage (NAS) systems.

This chapter contains the following topics.

NetBackup for NDMP Features NetBackup for NDMP Terminology Network Data Management Protocol (NDMP) Types of NDMP Backup NDMP Policies Storage Units NDMP Backup Process NDMP Restore Process Direct Access Recovery (DAR)

1


12/104

NetBackup for NDMP Features


NetBackup for NDMP includes the following features: Support for NDMP protocol versions V2, V3, and V4. Centralized backup-policy management

Scheduling, catalog management, and other backup tasks are managed from aNetBackup master server. NetBackup for NDMP may be installed on a NetBackupmaster or media server.

Device and media managementNetBackup Media Manager software provides complete management and control ofthe devices and media used for backups and restores of NDMP hosts. The NetBackupDevice Configuration wizard can discover and configure storage devices that areattached to an NDMP host (requires NDMP protocol versions V3 or V4). Note thatwizard-based discovery depends upon a number of device-specific features, such asSCSI inquiry and serialization, which may not be supported by all NAS vendors.

High speed local backup of NDMP hostsBackup data travels between disk and tape drives that are directly attached to thesame NDMP host. This provides high-speed backup without impairing networkthroughput.

Backup of network-attached NDMP hosts to a tape device on another NDMP host orto advanced tape libraries with embedded NDMP server.

Backup data travels across the network, from a disk on an NDMP host to tape onanother NDMP host. This is referred to as three-way backup. This data movementoption requires support from the NAS/NDMP host.

Backup of a network-attached NDMP host to a tape device on a NetBackup mediaserver. This is a form of three-way backup also known as remote NDMP. This featuresupports NDMP versions V2, V3, and V4 on the NDMP hosts.

Shared tape librariesTape libraries can be shared between NDMP hosts and NetBackup servers, or

between multiple NDMP hosts. Robotic control can be on an NDMP host or on aNetBackup server.

Shared tape drives with the Shared Storage OptionTape drives can be shared between servers (both NetBackup servers and NDMPhosts). This requires the Shared Storage Option (SSO) license. To see if your NASvendor supports SSO, refer to the NetBackup for NDMP Supported OS and NAS

Appliance Information document (see NetBackup for NDMP Information on the Webon page x for help accessing this document).

2 NetBackup for NDMP System Administrators Guide


13/104


Snapshots of data on NDMP hostsNetBackup can make point-in-time snapshots of data on an NDMP (NAS) host

without interrupting client access to the data, using the NDMP V4 snapshotextension. The snapshot is stored on the same device that contains the NDMP clientdata. From the snapshot, you can restore individual files or roll back a file system orvolume, by means of Advanced Client Instant Recovery. A NetBackup AdvancedClient license is required, in addition to the NetBackup for NDMP license. ThisAdvanced Client feature uses the NAS_Snapshot method. Refer to the NetBackup

Advanced Client System Administrators Guide for details.

NetBackup can also create a SnapVault disk copy from a NAS snapshot.Configuration details are contained in the NetBackup Advanced Client System

Administrators Guide.

For a list of NAS vendors that NetBackup currently supports for SnapVault andNAS_Snapshot, refer to theAdvanced Client Configuration and Compatibility onlinedocument (see the preface of this manual for help accessing that document).

Direct Access Recovery (DAR)For NDMP hosts that support DAR, this feature can greatly reduce the time it takes torestore a single file or small number of files.

Path-based file historyThe NDMP server can send catalog information consisting of complete path names toNetBackup. This feature is not supported by all vendors. For up-to-date informationon the vendors supporting path-based history, refer to NetBackup for NDMPInformation on the Web on page x.

NetBackup for NDMP servers are supported in a NetBackup clustered environment. The enhanced ability to execute customized scripts during a backup, especially for

relational databases residing on NAS devices.

Chapter 1, Introduction to NetBackup for NDMP 3


14/104

NetBackup for NDMP Terminology


This section introduces NetBackup for NDMP terminology. For explanations of otherNetBackup terms, consult the NetBackup online glossary in NetBackup help.

DAR (Direct Access Recovery)

The NDMP host positions the tape to the exact location of the requested file(s), readingonly the data needed for those files. Restore times can be reduced from hours to minutes.

NDMP (Network Data Management Protocol)

NDMP is a widely used protocol through which an NDMP-conformant backupapplication can control the backups and restores for an NDMP host.

NDMP Backup to Media Manager Devices

This is a form of three-way backup/restore also known as Remote NDMP, in which datatravels from an NDMP host to a tape drive attached to a NetBackup media server.

NDMP Client

An NDMP client is an NDMP-compliant backup application (also known as a DataManagement Application or DMA) that is a client of an NDMP server application. AnNDMP client sends commands to the NDMP server application to control the backupsand restores on an NDMP host.

NetBackup for NDMP is an application that allows NetBackup to be an NDMP client.

NetBackup for NDMP Server

A NetBackup for NDMP server is a NetBackup master or media server that has

NetBackup for NDMP software installed on it.

NDMP Host

A NAS system that serves files to clients using HTTP, FTP, CIFS, or NFS protocols. It alsoruns an NDMP server application that communicates with NDMP client backup softwareto configure and perform backup and restore tasks.

NAS systems are designed to provide fast, multi-protocol file access and cost effective

data storage to workstations and servers in the network or across the Internet.In a NetBackup configuration, the NDMP host is considered a client of NetBackup.However, NetBackup client software is never installed on an NDMP host.

NDMP Server Application

An NDMP server application runs on an NDMP host and executes backup, restore, anddevice control commands that it receives from an NDMP-conformant backup application.The backup application (NetBackup) is considered an NDMP client.



15/104


A separate instance of an NDMP server process exists for each connection to an NDMPclient. That is, if two backups are in progress, an NDMP server process exists for each

backup.

NDMP Storage Unit

An NDMP storage unit stores the backup data for an NDMP host. The tape drives in thisstorage unit attach directly to the NDMP host or can be configured on a SAN.

Note that NDMP storage units cannot be used to store data for non-NDMP hosts, andNetBackup disk storage units cannot be used for NDMP tasks.

Redirected Restore (to a Different Client)In a redirected restore, files are restored to a client other than the one from which theywere originally backed up. In NetBackup for NDMP, this means the restore data travelsfrom an NDMP host (or NetBackup media server) with a locally attached storage deviceto another NDMP host on the network.

Remote NDMP

See NDMP Backup to Media Manager Devices.

Three-Way Backup/Restore

In a three-way backup or restore, data travels between an NDMP host and a storagedevice attached to another NDMP host or to a NetBackup media server. This contrastswith local NDMP backup/restore, where the data travels between an NDMP hosts diskand a storage device directly attached to the same NDMP host.



16/104

Network Data Management Protocol (NDMP)

Network Data Management Protocol (NDMP)

NDMP is a widely used protocol through which an NDMP-conformant backupapplication can control the backups and restores of any NDMP host that is running anNDMP server application.

NDMP architecture follows the client/server model:

The NetBackup master or media server that has NetBackup for NDMP installed iscalled a NetBackup for NDMP server.

The host where the NDMP server application resides is called an NDMP host. The NetBackup software is a client of the NDMP server application. The NetBackup

for NDMP application allows NetBackup to be an NDMP client. The NDMP hosts, onthe other hand, act as NetBackup clients.

NDMP and NetBackup Hosts as Clients of Each Other

Network

NetBackup for NDMP server NDMP Host NDMP HostThis is a NetBackup master or

media server with NetBackup NDMP hosts act as NetBackup clients...for NDMP installed.

The NetBackup for NDMP server NOTE: NetBackup software is NOT installed

acts as an NDMP client. on NDMP hosts.



17/104

Types of NDMP Backup


The NDMP server application on the NDMP host performs backups and restores of theNDMP host, directed by commands received from an NDMP client (NetBackup). Backupscan be conducted in any of the following ways:

NDMP local backup NDMP three-way backup Backup to a Media Manager device on the NetBackup server

NDMP Local Backup

The NetBackup for NDMP server initiates the backup. The data travels from the NDMPhosts disk to a storage device attached to the same host, or to a device available on a SAN.

NDMP Local Backup/Restore

LAN/WAN

NetBackup for

NDMP server

NDMP

host

Tape libraryDisks

Local NDMP backup

Storage devices on SAN

FC/SAN

Data travels from disk to tape on same NDMP host, orfrom disk to tape device on SAN. Backup data is NOT

sent over local network.

The tape drives must be in NDMP-type storage units.



18/104


NDMP Three-Way Backup

The NetBackup for NDMP server initiates the backup. The data travels over the network,

from an NDMP host to a storage device that is attached to another NDMP host on thelocal network or available on a SAN.

NDMP Three-Way Backup/Restore

LAN/WAN

NDMP NDMPhost Host

NetBackup for

NDMP server

Disks Tape library

Three-Way NDMP backup

Data travels from disk on an NDMP host to tape device

on another NDMP host. Backup data is sent over the

local network.

The tape drives must be in NDMP-type storage units.



19/104


Backup to Media Manager Storage Devices (Remote NDMP)

The data travels over the network from an NDMP host to a Media Manager-type storage

device attached to a NetBackup media server or available on the SAN.

NDMP Backup to a Media Manager Device (Remote NDMP)

LAN / WAN

NetBackup NDMP

for NDMP hostserver

Storage Devices on SAN

FC/SAN

Tape library Disks

To NetBackup Server-Attached Media Manager Storage Units

Data travels from NDMP host to a drive on a NetBackup media server or on a

SAN. Backup data is sent over the local network.

NOTE: The NetBackup drive(s) must be in Media Manager type storage units.



20/104

NDMP Policies

NDMP Policies

After installing and configuring NetBackup for NDMP, you can schedule backups bycreating an NDMP policy in NetBackup.

An NDMP policy can have one or more NetBackup clients. Each NetBackup client mustbe an NDMP host (see figure NDMP and NetBackup Hosts as Clients of Each Other onpage 6). Note that you do not install any NetBackup software on the NDMP hosts.

The allowable backup types for schedules in an NDMP policy are: Full, CumulativeIncremental, or Differential Incremental. User initiated backups and archives are notallowed, because the NDMP protocol does not permit these tasks.

Restores of NDMP host backups can be initiated from any NetBackup media server that iswithin the same overall NetBackup storage domain and uses the same NetBackup masterserver as used by the media server that performed the backup. The data can be restored tothe NDMP host where it was backed up, or to another NDMP host.

NDMP policies can use either NDMP storage units or Media Manager storage units.



21/104

Storage Units

Storage Units

NetBackup uses either NDMP-type storage units (for local or three-way backup), orMedia Manager storage units (for backup to devices attached to a NetBackup mediaserver).

NDMP Storage Units

When backing up NDMP host data to devices attached to an NDMP host or available tothe NDMP host on a SAN, NetBackup requires NDMP-type storage units.

An NDMP storage unit can contain standalone or robotic drives. Robotic controls can bein a TLD (Tape Library DLT), TL8 (Tape Library 8MM), TLH (Tape Library Half Inch), orACS robot type.

Media Manager Storage Units

When backing up NDMP host data to devices attached to a NetBackup for NDMP serveror available to the server on a SAN, you can use drives configured in Media Manager-typestorage units.

For NDMP backup, drives in Media Manager-type storage units do not have to bededicated to NDMP data: they can store backups of regular (non-NDMP) NetBackupclients as well as of NDMP clients.

Refer to the Configuring NDMP Backup to NetBackup Media Servers chapter for

configuration help.

Assigning Tape Drives to Different Hosts

Robotic tape drives can be divided up among NDMP hosts and NetBackup servers. Forexample, referring to the NDMP and Non-NDMP Storage Units diagram:

Tape drives 1, 3, and 5 are attached to NDMP hosts and are in NDMP storage unitsthat can be used for NDMP backup (local or three-way).

The commands that control these drives originate on the NetBackup for NDMP serverand are sent through the NDMP connection on the network. The NDMP serverapplication on each NDMP host translates the NDMP commands into SCSIcommands for the local drives.

Tape drives 2 and 4 are attached to a NetBackup server and are in non-NDMP storageunits, controlled in the same way as other drives on NetBackup servers. Dependingon the type of storage unit, these drives can be used for the following:

For non-NDMP clients of NetBackupChapter 1, Introduction to NetBackup for NDMP 11


22/104

Storage Units

In the case of tape drives in Media Manager storage units, they can be used forboth NDMP (local or three-way) and non-NDMP backup.

In this diagram, all tape drives except drive 4 can be used for NDMP backup.

NDMP and Non-NDMP Storage Units

LAN/WAN Drive-control commands for NDMP

NDMP

NDMP

NB forhost

media

server

#

Drive 2

Drive 4

+

*

NDMP

host

#

Drive 3

#

TLD

Robot

NDMP

host

Drive 5

Drives 1, 3, and 5 (in NDMP storage units) can be used for

NDMP backups.

Drive 2 (in Media Manager storage unit) can be used for NDMP

or non-NDMP backup.

Drive 4 (in different type of NetBackup storage unit) cannot be

used for NDMP backup.

Drive 1

# In NDMP storageunit

+ In NetBackupMedia Manager

storage unit

* In another type ofNetBackup storage

unit (not NDMP or

Media Manager)



23/104

Storage Units

Robotics control can be attached to an NDMP host or to a NetBackup server, as follows.

NDMP hostCommands are sent by NetBackup over the network to the NDMP host, which in turnsends them to the robot.

Robotics Control Attached to an NDMP Host

NetBackup

for

NDMP

Server

Commands to

control robot

NDMP

Host

Robot

Robotic

Control

NetBackup serverThe robot is controlled in the same way as other robots on NetBackup servers.

Robotics Control Attached to a NetBackup Server

NetBackup NDMP

Server Host

Commands to

control robot

Robot

Robotic

Control


NDMP B k P


24/104

NDMP Backup Process

NDMP Backup Process

The following diagram (NetBackup Backup Processes.) shows the NetBackup processes

that are involved in NDMP backups. During a backup, the following events occur:

1. From the EMM database, NetBackup obtains a media ID for the tape that will be usedfor the backup and sends a tape-mount request to ltid.

2. ltid on the NetBackup for NDMP server sends the NDMP (SCSI robotic) commandsnecessary to get the requested tape mounted on the storage device.

3. NetBackup sends the NDMP commands necessary to have the NDMP serverapplication perform a backup to the tape. The backup data travels in one of two ways:

Between the local disk and tape drives on an NDMP host. Over the network, from an NDMP host without its own storage device to a

NDMP host (or NetBackup media server) with a locally attached storage device(three-way backup).

4. The NDMP server application sends information to the NetBackup for NDMP serverabout the files that were backed up. This information is stored in the NetBackup filedatabase.

5. The NDMP server application sends status about the backup operation to theNetBackup for NDMP server.


NDMP Backup Process


25/104

NDMP Backup Process

NetBackup Backup Processes.

NetBackup Master Server

bprd

NetBackupAdministration

Console

bpdbm

bpcd

bpbrm

bptm

ltid

Configuration

Database

File

Database

Catalog

information

TapeR

equest

Network

Connection

NDMP Host

Tape

OS

NDMP Server

Disk

NDMP Host

OS

Disk

3-way

Local

NetBackup Master

or Media Server

This server has

NetBackup for NDMP

ndmpagent

NDMP Server

nbpem

EMM

database nbjm

nbrb

nbproxy

nbproxy

nbemm


NDMP Restore Process


26/104



Because of the design of the NDMP protocol, only an administrator on a NetBackup

server (master or media) can restore files from NDMP backups. During a restore, theadministrator browses the file catalog and selects files from NDMP images in the samemanner as for standard backup images.

NetBackup Restore Processes shows the NetBackup processes involved in NDMPrestores. The following events occur during a restore:

1. The NetBackup for NDMP server looks in its EMM database for the tape that contains

the backup, and asks ltid to mount that tape.

2. ltid on the NetBackup for NDMP server sends the NDMP commands necessary toget the requested tape loaded on the storage device.

3. NetBackup sends the NDMP commands necessary to have the NDMP serverapplication perform a restore operation to the disk. The restore data travels in one oftwo ways:

From a tape drive to a local disk (tape drive and disk are on the same NDMP host) Over the network, from an NDMP host (or NetBackup media server) with a

locally attached storage device to another NDMP host (three-waybackup/restore)

4. The NDMP server application sends status about the restore operation to theNetBackup for NDMP server.




27/104


NetBackup Restore Processes

bpcd

Backup, Archive, and Restore(on master or media server)

bprd

NetBackup Master Server

bprd is on the

master server

NetBackup Master

or Media Server

bptm

Network

ConnectionEMMdatabase

bpbrm

ltid

NetBackup Media ID

TapeR

equest

NDMP Host

Tape

OS

Disk

NDMP Host

OS

Disk

This server has

NetBackup for NDMP.

ndmpagent

NDMP Server NDMP Server

3-way

Local


Direct Access Recovery (DAR)


28/104

y ( )

Direct Access Recovery (DAR)

Quickly restoring a single file or group of files from a backup image created by NetBackup

for NDMP can be accomplished automatically using Direct Access Recovery (DAR). DARcan greatly reduce the time it takes to restore files. DAR is enabled by default (noconfiguration required).

There are two prerequisites for using DAR with NetBackup for NDMP:

DAR must be supported by the NDMP host where the NDMP server applicationresides.

The backup must have been made by NetBackup 4.5 GA or later, with the catalog inbinary format (binary format is the default).Note File-level DAR is supported; directory-level DAR is not supported.

DAR enables the NDMP host to position the tape to the exact location of the requestedfile(s), reading only the data needed for those files. NetBackup automatically determineswhether DAR will shorten the duration of the restore, and activates DAR only when it

will result in a faster restore.NetBackup DAR can be disabled for all NDMP policies (see Enabling/Disabling DARon page 40).



29/104

2Installing NetBackup for NDMP

This chapter explains how to install the NetBackup for NDMP application on NetBackup

servers.

Installation Notes

The NetBackup for NDMP master/media server must be running NetBackup 6.0 orlater.

The NetBackup for NDMP 6.0 software supports Solaris, HP-UX, Red Hat Linux, AIX,and Windows 2000/2003 (including 64-bit) master or media servers.

For a detailed list of NAS platforms supported by NetBackup for NDMP, refer toNetBackup for NDMP Information on the Web on page x.

For making snapshots of NDMP (NAS) hosts, NetBackup Advanced Client softwaremust be installed on the NetBackup master server, and on the clients that are used toperform backups. For more information, refer to the NetBackup Advanced Client System


Drives and robots attached to the NDMP host must be types supported by the NDMPhost and NetBackup. See NDMP Storage Units on page 11 for a list of supportedrobot types. For more information on storage devices, see the NetBackup Media

Manager System Administrators Guide (UNIX or Windows).

For notes and tips on your particular NDMP host, refer to NetBackup for NDMPInformation on the Web on page x.

19

Installing on UNIX Servers


30/104

Installing on UNIX Servers

Note If you are installing in a cluster environment, you must freeze the active node beforeyou begin the installation process so that migrations do not occur duringinstallation. For information about freezing a service group, see the clusteringsection in the NetBackup High Availability System Administrators Guide for the clustersoftware you are running.

On the UNIX host that you want to be the NetBackup for NDMP server, do the following:

1. Log in as root.

2. Install NetBackup server and client software as explained in the NetBackup InstallationGuide for UNIX.

3. Make sure a valid license key for NetBackup for NDMP has been registered byentering the following command to list and add keys:

/usr/openv/netbackup/bin/admincmd/get_license_key

4. Insert the CD-ROM containing NetBackup for NDMP software in the drive.

5. Change your working directory to the CD-ROM directory:

cd /cd_rom_directory

Where cd_rom_directoryis the path to the directory where you can access theCD-ROM. On some platforms, it may be necessary to mount this directory.

6. To install NetBackup for NDMP, execute the following:

./install

Since other NetBackup products are included on the CD-ROM, a menu appears.

7. Select NetBackup Add-On Product Software.

a. Select the NetBackup for NDMP option.

b. Enter q to quit the menu.

c. When asked if the list is correct, answery.

8. If this NetBackup for NDMP server is not your master server, also install your NDMP

license key on the master.

9. In a clustered environment, the above steps must be done on each node in the cluster.


Installing on Windows Servers


31/104

Note If you are installing in a cluster environment, unfreeze the active node after theinstallation completes. For information about unfreezing a service group, see the

clustering section in the NetBackup High Availability System Administrators Guide forthe cluster software you are running

Installing on Windows Servers

Note If you are installing in a cluster environment, you must first freeze the active node

so that migrations do not occur during installation. For information about freezing aservice group, see the clustering section in the NetBackup High Availability System

Administrators Guide for the cluster software you are running.

On the Windows host that you want to be the NetBackup for NDMP server, perform thefollowing:

1. Log in.

2. Install NetBackup server and client software as explained in the NetBackup InstallationGuide for Windows.

3. NetBackup for NDMP is part of the core NetBackup product. Make sure a validlicense key for NetBackup for NDMP has been registered by doing the following tolist and add keys:

a. From the NetBackup Administration window, choose Help.

b. From the Help menu, select License Keys ....

The NetBackup License Keys window appears. Existing keys are listed in thelower part of the window.

c. To register a new key, click the star icon to open the Add a new License Key

dialog. Type the new license key in the New license key field and click Add.The new license key appears in the lower part of the dialog box.

4. If this NetBackup for NDMP server is not your master server, install your NDMPlicense key on the master.

5. In a clustered environment, the above steps must be done on each node in the cluster.

Chapter 2, Installing NetBackup for NDMP 21

Uninstalling NetBackup for NDMP


32/104

Note If you are installing in a cluster environment, unfreeze the active node after theinstallation completes. For information about unfreezing a service group, see the

clustering section in the NetBackup High Availability System Administrators Guide forthe cluster software you are running

Uninstalling NetBackup for NDMP

On the server where you initially loaded the NetBackup for NDMP software, do thefollowing. This procedure results in total removal of the NetBackup for NDMP software.

Note In a cluster environment, you must first freeze the active node so that migrations donot occur during installation. For help freezing a service group, see the clusteringsection in the NetBackup High Availability System Administrators Guide for the clustersoftware you are running.

1. Check the Activity Monitor in the Administration Console to make sure noNetBackup for NDMP backups are active or running (State field reads Done).

2. If ltid is running, stop it (use the Activity Monitor > Daemons tab).

3. Pre-6.0 NetBackup on Solaris only: if ndmpmoveragent is running (check the ActivityMonitor > Processes tab), stop it by entering the following:

cd /usr/openv/volmgr/bin

./ndmpmoveragent.stop

4. To remove the NetBackup for NDMP package, enter the following:

On Solaris:

pkgrm VRTSnbdmp

On other UNIX platforms:

rm -f /usr/openv/lib/libndmp_bpfsmap.s?

rm -f /usr/openv/lib/libndmpclient.s?rm -f /usr/openv/volmgr/bin/set_ndmp_attr

rm -f /usr/openv/share/version_ndmp

rm -f /usr/openv/netbackup/bin/ndmpmoveragent

where ? is a wildcard.

5. Restart ltid.

Note If uninstalling in a cluster environment, unfreeze the active node after the uninstall.



33/104

3Configuring NDMP Backup to

NDMP-Attached Devices

This chapter explains how to configure backups on storage devices attached to NDMP

hosts. Only NDMP-specific steps are described.

Note As an alternative to the device configuration procedures in this chapter, you can usethe NetBackup Device Configuration wizard to discover and configure robots anddrives that are attached to an NDMP host (requires NDMP protocol versions V3 orV4).

To configure and use the NAS_Snapshot method when backing up NDMP host data, see

the NetBackup Advanced Client System Administrators Guide.

The following topics are covered in this chapter:

Authorizing Access to the NDMP Host Media Manager Device Configuration Verifying NDMP Password and/or Robot Connection

Adding NDMP Storage Units Creating an NDMP Policy Enabling/Disabling DAR Setting Up Clustering Testing an NDMP Configuration

23

Authorizing Access to the NDMP Host


34/104


Before NetBackup can carry out backups, it must have access to the NDMP host. To

authorize this access, use the following dialog from the NetBackup AdministrationConsole on your NetBackup for NDMP master server. You can also use the NetBackupDevice Configuration wizard to create this authorization.

Note Do the following on the master server (not media server) if you are going to createsnapshots using the Advanced Client NAS_Snapshot method.

To authorize NetBackup access to the NDMP host (from Administration Console)

1. On the NetBackup server: under Media and Device Management > Devices, click onNDMP Hosts. Under Actions, choose New > NDMP Host.

The NDMP host name dialog appears.

2. Enter the name of the NDMP server that NetBackup will back up.

Note This NDMP host name is case-sensitive. Whenever this host name is used (such aswhen configuring tape drives and storage units for this host), the name must beidentical to the name entered here.

3. Click OK.

The New NDMP Host dialog appears.




35/104

The term credentials refers to the username and password that NetBackup will use toaccess the NDMP host.

Use the globalNDMP login.

Create a loginto this NDMPhost for allNetBackupservers.

Specify

differentNDMP loginsfor particularNetBackupservers.

4. Specify the following:

Use gobal NDMP credentials for this NDMP host

Select this option to enable all NetBackup media servers under the master server toaccess this NDMP host using a pre-defined global NDMP login. This login is createdunder Host Properties > Master Server > Properties > NDMP, on the NDMP GlobalCredentials dialog.

Use the following credentials for this NDMP host on all media servers

Select this option to enable all NetBackup media servers connected to the NDMP hostto access the NDMP host using the login you specify on this dialog:

Username: the user name under which NetBackup will access the NDMP server.This user must have permission to execute NDMP commands.

Chapter 3, Configuring NDMP Backup to NDMP-Attached Devices 25



36/104

Note To see if your NDMP host vendor requires a particular username or access level(such as root), refer to NetBackup for NDMP Information on the Web on page x.

Password and Confirm Password: enter the password for this user.Use different credentials for this NDMP host on each media server

Select this option to specify NDMP logins for particular NetBackup servers, then clickAdvanced Configuration. The Advanced NDMP Credentials dialog appears.

5. Click Add. The Add Credentials dialog appears.




37/104

6. Select a NetBackup server and specify the username and password it will use toaccess the NDMP host.

7. Click OK. NetBackup validates the username and password.

The NetBackup server and username appear in the Advanced NDMP Credentialsdialog.

8. If needed, click Add again to specify other servers and user names.

9. Repeat this procedure for each NDMP host that NetBackup will back up.

Access for Three-Way Backups and NDMP to Media Manager

To perform three-way backups, you must authorize access to the desired NDMP host asdescribed in the previous section.

Three-way backups: for the NDMP host name, specify the NDMP host that has noattached tape drive.

NDMP to Media Manager backups: for the NDMP host name, specify the NDMPhost that will be backed up to the media manager storage unit defined on theNetBackup server. See the chapter titled Configuring NDMP Backup to NetBackupMedia Servers for more information.


Media Manager Device Configuration


38/104


On the NetBackup for NDMP server, use Media and Device Management in the

Administration Console to add drives and robots. As an alternative, you can use theNetBackup Device Configuration wizard.

The following procedures and examples treat NDMP configuration issues only. See theNetBackup Media Manager System Administrators Guide for general information onconfiguring NetBackup media.

For more information on configuring storage devices for specific NDMP hosts, refer toNetBackup for NDMP Information on the Web on page x.

Note These procedures do not apply to setting up devices attached to the NetBackupmedia server. To back up NDMP data to Media Manager devices (remote NDMP),storage units are configured in the same way as ordinary NetBackup (non-NDMP)devices. For details, refer to Configuring NDMP Backup to NetBackup MediaServers on page 45, and to the NetBackup Media Manager System AdministratorsGuide.

Adding a Robot Directly Attached to an NDMP Host

Using the NetBackup Administration Console:

1. Start the NetBackup Administration Console on the NetBackup for NDMP server as

follows:On Windows: from the Windows Start menu, select Programs, VERITAS NetBackup,NetBackup Administration Console.

On UNIX, enter the following:

/usr/openv/netbackup/bin/jnbSA &

2. Select Media and Device Management > Devices in the left pane.

3. On the Actions menu, select New, then select Robot... from the popup. The AddRobot dialog appears.




39/104

Explained in online

help or in the

Media Manager

System

Administrators

Guide.

Explained in the

following steps.

For assistance with the Add Robot dialog, refer to the online help or to the NetBackupMedia Manager System Administrators Guide. The steps below explain the portions thatare unique to configuring NetBackup for NDMP.

4. For Media Manager host, specify the host that manages the EMM database (by

default, this is the NetBackup master server).

5. For Device host, use the pull-down to select the NetBackup media server.

6. Specify Robot type and number as explained in the NetBackup Media Manager SystemAdministrators Guide.

7. Under Robot control, click Robot control is attached to an NDMP host.



40/104


Addi D i


41/104

Adding a Drive

Using the NetBackup Administration Console:

1. Select Media and Device Management > Devices in the left pane.

2. On the Actions menu, select New, then select New Drive (on UNIX, Tape Drive) fromthe popup. The Add Drive dialog appears.

3. For Drive Name: Enter the name of the drive.

4. For Host and path information:

a. Click Add to specify a drive path.



The Add Path dialog appears:


42/104

The Add Path dialog appears:

b. For Device host, select the name of the NetBackup media server. Use thepull-down to select media servers already defined, or click Add to enter a newone.

c. For Path (called No rewind device on UNIX), enter the device file name of thetape drive, such as nrst2a. Refer to the NAS vendor documentation for your drivefor the correct format of the device file name.

As an alternative, you can use the following command to find the device filename for the drive, if the NDMP host is running NDMP protocol V3 or later:

tpautoconf -probe ndmp_host_name

d. Click This path is for a Network Attached Storage device.

e. For NDMP Host, use the drop-down to select the name of the NAS filer to whichthe drive is attached.

f. When finished, click OK.

5. Back on the Add a New Drive dialog, enter the Drive information as required.

6. Repeat this procedure for each drive that must be added.

When asked whether or not to restart the Media Manager device daemon and allrobotic daemons, click Yes.



Checking a Media Manager Configuration


43/104

Checking a Media Manager Configuration

On the NetBackup for NDMP server, do the following:

On UNIX, execute /usr/openv/volmgr/bin/vmps and verify that ltid, vmd,avrd, and any required robotic daemons are active. On Windows, go to theNetBackup Administration Console and use the Activity Monitor (Processes tab) toverify that the above processes are active.

From the NetBackup Administration Console, use the Device Monitor to ensure thatthe drive is in the UP state.

Adding Volumes to a Media Manager Configuration

Use the NetBackup Media and Device Management utility to add the volumes that youwill be using for the NDMP host backups. See theMedia Manager System AdministratorsGuide for instructions.

Note When specifying the Robot Control Host for a volume that will be in a robot, specifythe host name for the NetBackup for NDMP server, not the NDMP host.


Verifying NDMP Password and/or Robot Connection



44/104


When you authorize NetBackup access to the NDMP host and configure robots using the

Administration Console, NetBackup automatically verifies your NDMP credentials andthe robotic configuration. If desired, you can re-verify them. For example:

tpautoconf -verify ndmp_host_name

A successful verification looks like the following:

Connecting to host "stripes" as user "root"...

Waiting for connect notification message...

Opening session--attempting with NDMP protocol version 4...

Opening session--successful with NDMP protocol version 4

host supports MD5 authentication

Getting MD5 challenge from host...

Logging in using MD5 method...

Host info is:

host name "stripes"

os type "NetApp"

os version "NetApp Release 7.0.0.1"host id "0033625811"

Login was successful

Host supports LOCAL backup/restore

Host supports 3-way backup/restore


Adding NDMP Storage Units



45/104


On the NetBackup master server, add an NDMP-type storage unit for the devices that will

contain the backup data.Most of the requirements are the same as for adding a Media Manager storage unit. Thefollowing topics explain the differences when adding an NDMP storage unit. See theNetBackup System Administrators Guide for more information.

Note NDMP-type storage units are not used for backups to media server-attacheddevices. Use Media Manager storage units, not NDMP-type units. Refer to theConfiguring NDMP Backup to NetBackup Media Servers chapter for details.

1. In the NetBackup Administration Console, select NetBackup Management > StorageUnits.

2. On the Actions menu, select New > Storage Unit. The New Storage Unit dialogappears.



3. For Storage unit name, enter a unique name for the storage unit.


46/104

g q g

4. For Storage unit type, select NDMP.

5. For On demand only: this specifies whether the storage unit is available only when apolicy or schedule specifically requests it. If this option is not used, the storage unit isavailable to any NDMP policy or schedule.

6. For Storage device, select the type of device for this storage unit.

7. For NDMP host, specify the NDMP host where the tape drive is physically attached.

The remaining fields are described in the NetBackup System Administrators Guide.


Creating an NDMP Policy



47/104

C ea g a o cy

On the NetBackup master server, create an NDMP policy to configure backups of the

NDMP host.

Note You can use the Backup Policy Configuration wizard to create NDMP policies.

Creating an NDMP policy is very similar to creating other NetBackup policy types. Thefollowing topics explain the differences when creating NDMP policies.

See the NetBackup System Administrators Guide for more information on NetBackuppolicies and the Policy utility.

Note To configure a policy for the NAS_Snapshot method and SnapVault, see theNetBackup Advanced Client System Administrators Guide.

Attributes

Specify the following policy attributes:

Policy Type: NDMP Policy Storage Unit:

If the NDMP host has more than one storage unit and you want to direct backupsfor this policy to a specific storage unit, specify the name of that storage unit.

For a three-way backup, specify a storage unit that was defined for the targetNDMP host with attached tape.

For NDMP backup to Media Manager devices, specify a Media Manager storageunit defined for a device connected to a NetBackup media server (see theConfiguring NDMP Backup to NetBackup Media Servers chapter).

Clients

In the client list, specify the following for each client in an NDMP policy: Hostname

Name of the NDMP host

Hardware and operating systemNDMP NDMP



Files


48/104

The Backup Selections list must specify directories from the perspective of the NDMPhost.

Two examples:

/home/dir1/

/vol1

The following Backup Selections capabilities are NOT supported for an NDMP policy:

Wildcards in pathnames. For example, /home/* is an invalid entry. Individual file names. Only directory or volume names are allowed. Exclude list (because client software is not installed on the NDMP host). You can,

however, exclude files by using the SET keyword as shown under UsingEnvironment Variables in Backup Selections list. The SET option allows you toexclude files on a backup. The format is vendor dependent; refer to the vendorsdocumentation for more details on which variable can be passed and in what format.

Schedules

You can specify any of the following backup types in a schedule for an NDMP policy:

Full Cumulative Incremental Differential IncrementalSpecify Override policy storage unit only if this client of NetBackup (the NDMP host) hasmore than one storage unit and you want to use a specific storage unit for this schedule. Inthis case, the client must be the only client in this NDMP policy.

Using Environment Variables in Backup Selections list

NDMP allows you to use environment variables to pass configuration parameters to an

NDMP host with each backup. NDMP environment variables can be one of the followingtypes.

Defined as optional by the NDMP protocol specification.You can set these variables.

Specific to an NDMP host vendor.You can set these variables.

Reserved for use by NetBackup:



FILESYSTEM


49/104

LEVEL

DIRECTEXTRACT

ACL_START

In NetBackup, environment variables can be set within the Backup Selections list byspecifying one or more SET directives.

Note In the Backup Selections list, the SET directive must be the first in the list, followedby the file systems or volumes to back up. To obtain up-to-date information onenvironment variables relating to particular NAS vendors, refer to NetBackup forNDMP Information on the Web on page x.

In general, the syntax of a SET directive is as follows:

SET variable = value

Where variableis the name of the environment variable and valueis the value that isassigned to it. The value can be enclosed in single or double quotes, and must be enclosedin quotes if it contains a space character. For example:

SET ABC = 22

SET DEF = "hello there"

SET type = tar

Setting a variable equal to no value unsets that variable. For example:

SET ABC =

Variables accumulate as the Backup Selections list is processed. For example, if BackupSelections contains the following entries:

/vol/vol1

SET HIST = N

/vol/vol2

SET DEF = 20

SET SAMPLE = all/vol/vol3

Directory/vol/vol1 will be backed up without any user-specified environmentvariables. The second directory (/vol/vol2) will be backed up with the variable HISTset to N. The third directory (/vol/vol3) will be backed up with all three of theenvironment variables set.

If an environment variable appears again later in the list, the value of this variable

overrides the previous value of the variable.


Enabling/Disabling DAR

The values used in each backup are saved and provided to subsequent restores of thedirectory The NDMP host may have environment variables that are set internally and


50/104

directory. The NDMP host may have environment variables that are set internally andthese are also saved for restores.


By default, NetBackup for NDMP is configured to use Direct Access Recovery (DAR). Foreach restore, NetBackup automatically determines if the use of DAR will speed up therestore. NetBackup uses DAR only when it will result in a faster restore.

Note NetBackup can use DAR only if the NDMP NAS host supports it (contact your NASvendor for details).

DAR can be turned off if desired. This may be necessary if you are having problems withDAR and your NDMP host is an older machine or is not running the latest NAS OSversion.

1. In the NetBackup Administration Console, expand Host Properties and click on

Master Servers or Media Servers.

2. Right-click on the name of the server and select Properties.

3. Click on General Server.



This is the UNIX version of the Properties dialog, General Server:


51/104



This is the Windows version of the Properties dialog, General Server:


52/104

4. Uncheck the Use direct access recovery for NDMP restores box, and click Apply.

This disables DAR on all NDMP restores.


Setting Up Clustering

Setting Up Clustering


53/104

Before configuring NetBackup for NDMP for clustering, the following must be installed

on each node of the cluster: NetBackup server (see the NetBackup Installation Guide). NetBackup for NDMP software (see Installing NetBackup for NDMP on page 19 of

this manual). Note that for Windows servers, only the NetBackup for NDMP licencekey has to be installed.

1. Configure NDMP-attached robots and drives, and then storage units and policies, just

as you would in a normal, non-clustered environment: You can use the Device Configuration wizard, or configure devices manually as

described under Authorizing Access to the NDMP Host on page 24 andfollowing.

To use the same robotic libraries throughout a cluster, robot numbers must beconsistent. The Device Configuration wizard attempts to ensure thisconfiguration. If you are configuring robots manually as described in this guide,

be sure to use the same robot number for a given robot, from one host to anotherin the cluster.

2. When finished configuring devices and policies for NetBackup for NDMP, fail-over tothe next node in the cluster and configure the drives and robots.

Select the same robot number that you used when configuring the robot for thefirst node.

Post-Installation Changes

After NetBackup has been configured in a clustered environment, most configurationinformation is available to all nodes in the cluster, by means of a shared hard drive.However, changes made in the Host Properties area of the Administration Console are notavailable on the shared drive. Such changes apply only to the active node. Host Propertieschanges made on the active node must be manually duplicated on each node, ifNetBackup is to perform exactly the same way in case of failover to another node. Refer tothe NetBackup High Availability Guide for assistance.


Testing an NDMP Configuration

Testing an NDMP Configuration


54/104

To test the configuration, run the backup and then restore some files. For instructions, see

the following topics: Performing an NDMP Backup on page 56. Performing a Restore from the Server on page 57.If you encounter problems, see Troubleshooting on page 59.



55/104

4Configuring NDMP Backup to NetBackup

Media Servers

This chapter describes how to configure NetBackup for NDMP to make backups to MediaManager storage units (remote NDMP). Only NDMP-specific steps are described.


Overview Configuring NDMP Backup to Media Manager Devices

45

Overview

Overview

U i f t k t NDMP b k NDMP d t t d i


56/104

Using a feature known as remote NDMP, you can back up NDMP data to a drive

configured in a Media Manager storage unit on a NetBackup media server. The drive canbe used for both NDMP backups and for non-NDMP backups. See the following diagram.

NDMP Backup to a Media Manager Storage Unit

LAN / WAN

NetBackup

for NDMPserver

NetBackup

drives in

Media

Manager

storage

unit(s).

NDMP hosts (NAS filers). . .

Data travels between NDMP hosts and a drive on a

NetBackup media server.

NOTE: The NetBackup media manager drive(s)

need not be dedicated to NDMP backups: they can

be used for non-NDMP backups as well.


Configuring NDMP Backup to Media Manager Devices


These are the basic steps to configure NDMP backups to Media Manager storage units


57/104

These are the basic steps to configure NDMP backups to Media Manager storage units.

1. Authorize the NetBackup server to access the NDMP hosts you want to back up.

Note Do the following on the master server (not media server) if you are going to createsnapshots using the Advanced Client NAS_Snapshot method.

a. Under Media and Device Management > Devices, click on NDMP Hosts. UnderActions, choose New > NDMP Host to display the NDMP Host dialog.

b. Fill in the values as described under Authorizing Access to the NDMP Host onpage 24.

c. Repeat the above for each NDMP host that the NetBackup server will back up.

2. Use the NetBackup Device Configuration wizard to configure the drive(s) androbot(s).

Note Do not use the device configuration procedure in the Configuring NDMP Backupto NDMP-Attached Devices chapter in this guide. Rather, configure the robots anddrives in the same way as ordinary Media Manager devices, described in theNetBackup Media Manager System Administrators Guide.

Note Drives can be shared using the Shared Storage Option (SSO) of NetBackup. For an

overview of the setup procedure, see Using The Shared Storage Option (SSO) onpage 49. The drives can be shared as both NDMP drives and non NDMP drives.

3. Create a Media Manager-type storage unit for the drive(s).

For details on storage units, refer to the NetBackup System Administrators Guide,Volume I.

Note The storage unit type must be Media Manager, not NDMP.

4. Create an NDMP-type policy. On the New/Change Policy display, be sure to specifythe storage unit created at step 3. See Creating an NDMP Policy on page 37.

Chapter 4, Configuring NDMP Backup to NetBackup Media Servers 47



58/104



59/104

5Using The Shared Storage Option (SSO)

This chapter describes the steps for setting up the Shared Storage Option with NetBackupfor NDMP.


Shared Storage Option (SSO): Basic Diagram Setting up SSO: Overview Using the Device Configuration Wizard

49

Shared Storage Option (SSO): Basic Diagram

Shared Storage Option (SSO): Basic Diagram

The following figure shows a robotic library on a SAN that can share its drives between


60/104

g g y

two NetBackup for NDMP servers and two NDMP hosts. Drive sharing requires a licensefor the Shared Storage Option. (A SAN is not required.)

NDMP Backup Using Shared Storage Option

LAN

NetBackup NetBackup NDMP NDMP for NDMP for NDMP host host

server 1 server 2

Fibre Channel SAN

(optional)

Drives in the tape library are shared by

NetBackup servers 1 and 2 for backing

up NDMP hosts.

Drives can be in Media Manager

storage units or NDMP storage units, orboth.

For each robot, robotic control can be handled by either a NetBackup media sever oran NDMP server (not both).


Setting up SSO: Overview

Setting up SSO: Overview

This is an outline of the steps for setting up access to a robotic drive shared between


61/104

p g p

NDMP and NetBackup servers.For a more complete discussion of SSO, refer to the Shared Storage Option (SSO) Topicschapter in the NetBackup Media Manager System Administrators Guide.

This procedure assumes the following:

That the requirements for SSO have been met, as described in the NetBackup MediaManager System Administrators Guide.

That all physical devices, including the NDMP host, are correctly connected to thenetwork.

That the NDMP host is supported by NetBackup for NDMP. For a document that listssupported NAS systems, see NetBackup for NDMP Information on the Web onpage x.

1. Configure NetBackup access to the NDMP host.

For details, see Authorizing Access to the NDMP Host on page 24.

2. Verify that the NDMP host can access the required robots and drives.

To verify NDMP host access to the required devices, run the following commands ona NetBackup media server that is authorized to access the NDMP host:

tpautoconf -verify ndmp_host_name

tpautoconf -probe ndmp_host_name

The -verify option verifies that the NetBackup server can access the NDMP host;the -probe option lists the devices that are visible to the NDMP host.

3. From the NetBackup Administration Console, use the Device Configuration Wizardto configure the devices and storage units. See Using the Device ConfigurationWizard on page 52.

Note An NDMP storage unit must be defined for each NDMP host that will besharing a drive. If all hosts have access to the shared drive(s), the DeviceConfiguration Wizard can create these storage units automatically.

Chapter 5, Using The Shared Storage Option (SSO) 51

Using the Device Configuration Wizard


The most convenient way to configure devices and storage units for NDMP hosts (with or


62/104

without the SSO option) is to use the Device Configuration Wizard.

1. In the NetBackup Administration Console, click Configure Storage Devices to launchthe Device Configuration Wizard.

2. Click Next on the Welcome screen. The Device Hosts screen appears.

3. Under Device Hosts, place a check beside the NetBackup media server that willaccess the NDMP host, click on the server name to highlight it, and click Change.



The Change Device Host screen appears.


63/104

4. Place a check beside NDMP server and click OK.

The Device Hosts screen re-appears. NDMP is now listed in the Optional Devicesto be Scanned column for the media server (screen detail shown below).

5. On the Device Hosts screen, click Next to continue.

Chapter 5, Using The Shared Storage Option (SSO) 53


The NDMP Hosts screen appears, showing the NDMP host(s) on which you canconfigure devices.


64/104

6. On the NDMP Hosts screen, click Next to configure the NDMP-attached devices.

7. Follow the screens in the wizard to complete the configuration.



65/104

6Backup and Restore Procedures

This chapter describes the procedures for backing up and restoring NDMP-type policies.For backup and restore of a NAS snapshot, refer to the NetBackup Advanced Client System


Performing an NDMP Backup Performing a Restore from the Server

55

Performing an NDMP Backup

Performing an NDMP Backup

Only the administrator can perform NDMP backups and restores on the NetBackupserver (master or media) The NDMP protocol does not allow users to initiate a backup or


66/104

server (master or media). The NDMP protocol does not allow users to initiate a backup orrestore, and there is no NetBackup client software installed on an NDMP host.

Automatic Backup of an NDMP Policy

To configure an NDMP policy and set up schedules for automatic, unattended backups,see Creating an NDMP Policy on page 37 and the NetBackup System AdministratorsGuide.

Manual Backup of an NDMP Policy

Only a NetBackup administrator can initiate an NDMP backup. The following procedureexplains how to perform the backup using the NetBackup Administration Console. Forfurther information on the NetBackup Administration Console, see the NetBackup System

Administrators Guide (Windows or UNIX).

1. As administrator, start the NetBackup Administration Console on the NetBackupserver as follows:

On Windows: from the Windows Start menu, select Programs, VERITAS NetBackup,NetBackup Administration Console.

On UNIX, enter the following:

/usr/openv/netbackup/bin/jnbSA &

2. Click on Policies. Right click on the NDMP policy name and select Manual Backupfrom the pop-up menu.

This opens the Manual Backup dialog.

3. In the Manual Backup dialog, select a schedule, then select the clients (NDMP hosts)that you want to back up.

If you do not select any schedules, NetBackup uses the schedule with the highestretention level. If you do not select any clients, NetBackup backs up all configuredNDMP hosts.

4. Click OK to start the backup.


Performing a Restore from the Server


User-directed restores of files are not allowed, since there is no NetBackup client softwareinstalled on an NDMP host.


67/104

installed on an NDMP host.

The administrator can use the Backup, Archive, and Restore interface on a NetBackupserver (master or media server) to restore files to the NDMP host from which they were

backed up, or to a different NDMP host. For help with the basic restore procedure, see theNetBackup online help in the Administration Console, or the NetBackup Backup, Archive,and Restore Getting Started Guide.

Note the following:

In the Specify NetBackup Machines and Policy Type dialog, specify the following:

For the server, select the NetBackup master server. If your configuration has multiplemaster servers, specify the master server that has the policy for the NDMP host thatyou are restoring. If the server name is not in the pull-down, use Edit Server List toadd it.

For the source and destination clients, select the appropriate NDMP (NAS) hosts.

Note The destination host must be an NDMP host compatible with the data format of thesource (the source and destination must be of the same NAS vendor type).

Caution An NDMP restore always overwrites existing files.

If the desired hosts are not available in the pull-down, use Edit Client List to add theclient.

In the policy type field, select NDMP.

Chapter 6, Backup and Restore Procedures 57



68/104



69/104

7Troubleshooting

The following information may be useful in troubleshooting NetBackup.

NDMP Operating Notes and Restrictions

Troubleshooting NetBackup Troubleshooting Media Manager on Windows Systems Troubleshooting Media Manager on UNIX systems Troubleshooting DAR Testing a RobotNote For explanations of NetBackup status codes, refer to the NetBackup Status Codes

and Messages chapter in the NetBackup Troubleshooting Guide.

59



Before troubleshooting a suspected problem, review the following operating notes.

T b bl h f h l l NDMP h f


70/104

To obtain troubleshooting information that may apply to particular NDMP hosts, refer toNetBackup for NDMP Information on the Web on page x.

A tape created on an NDMP storage unit is in backup format and cannot be restoredfrom a non-NDMP storage unit. If you duplicate an NDMP backup image the newcopy is still in backup format and cannot be used for restores on a non-NDMP storageunit.

In the Backup Selections list for an NDMP policy, you can include only directorypaths. Wildcards and individual file names are not allowed.

You cannot back up files where the path length is greater than 1024 characters. The NDMP protocol uses port 10000 for communication. On UNIX systems, the NetBackup avrd process utilizes ICMP (Internet Control

Message Protocol) to ping NDMP hosts to verify network connectivity. This protocolis required for the NetBackup for NDMP product.

If backup or restore jobs are running slowly, verify that the network interface cards(NIC) are set to full duplex. Half duplex often causes poor performance. Forassistance viewing and resetting duplex mode for a particular NAS host, consult thedocumentation provided by the manufacturer. You may be able to use the ifconfig (oripconfig) command, as explained in the NetBackup Troubleshooting Guide.

Notes on DAR

DAR can be used when restoring backups that were made by NetBackup 4.5GA orlater. Starting with NetBackup 4.5GA, NetBackup stores the required DAR offsetinformation on each backup.

Note For backups made by pre-4.5GA versions of NetBackup, restores cannot use DAR,because the pre-4.5 versions did not store the DAR offset information.

DAR can be used when restoring files, but not when restoring directories.

Backups must have been performed with the NetBackup catalog set to binary mode.For backups made with the catalog set to ASCII mode, restores cannot use DAR,

because ASCII mode did not store the required DAR offset information on eachbackup. Note that all backups made prior to NetBackup 4.5 used ASCII catalog mode.

To use DAR with NetBackup, the NDMP host you want to restore must support DAR.Some NDMP host vendors do not currently support DAR.


Troubleshooting NetBackup


T f L


71/104

Types of LogsNetBackup uses two types of logging: unified logging, new in this 6.0 release, and legacylogging as used in previous releases. Both are described in the Using Logs and Reportschapter in the NetBackup Troubleshooting Guide.

Note:

All unified logs are written to /usr/openv/logs (UNIX) or install_path\logs(Windows). Unlike legacy logging, there is no need to create logging directories.

Use the vxlogview command to examine unified logs (see examples in the nextsection):

On UNIX: /usr/openv/netbackup/bin/vxlogview

On Windows: install_path\NetBackup\bin\vxlogview

Refer to the NetBackup Troubleshooting Guide for assistance in using the vxlogview

command. See also the vxlogview man page or the NetBackup Commands Guide.

Troubleshooting Steps

Check the NetBackup All Log Entries report for information about the failed job. To get more information about a problem, do the following:

In the NetBackup Administration Console: expand Host Properties in the leftpane, click on Media Server, and right click on the server name in the right pane.From the pop-up, select Properties, then click Logging and set the Globallogging level to 5. This increases logging detail to the highest level, for bothunified logging and legacy logging.

View the unified logging information in /usr/openv/logs (UNIX) orinstall_path\logs (Windows) for the following processes: ndmpagent(originator ID 134), ndmp (originator ID 151), nbpem (originator ID 116),nbjm(originator ID 117), and nbrb (originator ID 118).

For ndmpagent logs, try the vxlogview command as follows:

/usr/openv/netbackup/bin/vxlogview -i ndmpagent -d T,s,x,p

For ndmp logs, try the vxlogview command as follows:

/usr/openv/netbackup/bin/vxlogview -i ndmp -d T,s,x,p

Chapter 7, Troubleshooting 61


On the NetBackup for NDMP server, create bptm, bpbrm, and ndmpagent legacydebug log folders in the /usr/openv/netbackup/logs directory (UNIX) orinstall_path\NetBackup\logs folder (Windows). NetBackup writes legacy logfiles in these directories, if the directories exist.


72/104

Note The legacy and unified logging files can consume a lot of disk space; delete the logfiles when you are finished troubleshooting and set logging to a lower level ofdetail.

To verify that the appropriate services are

ndmp administration guid

Documents