NDMP Implementation Guide (EMC).book

for the 

NDMP Plugin and the EMC 2 IP4700 

NVE 7010-6C 03/25-04

Copyrights 

Software Copyright © 2004 BakBone Software 

NetVault Implementation Guide - NDMP Plugin and the EMC IP4700 

Copyright © 2004 BakBone Software 

Printed and online versions. 

This software product is copyrighted and all rights are reserved. The distribution and sale of 

this product are intended for the use of the original purchaser only per the terms of the 

License Agreement. All other product trademarks are the property of their respective owners. 

The NetVault Implementation Guide - NDMP Plugin and the EMC IP4700 documentation is 

copyrighted and all rights are reserved. 

This document may not, in whole or part, be copied, photocopied, reproduced, translated, 

reduced or transferred to any electronic medium or machine-readable form without prior 

consent in writing from BakBone Software. 

THIS PUBLICATION IS PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER 

EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 

WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR 

NON-INFRINGEMENT. 

THIS PUBLICATION COULD INCLUDE TECHNICAL INACCURACIES OR 

TYPOGRAPHICAL ERRORS. CHANGES ARE PERIODICALLY ADDED TO THE 

INFORMATION HEREIN; THESE CHANGES WILL BE INCORPORATED INTO NEW 

EDITIONS OF THE PUBLICATION. BAKBONE SOFTWARE MAY MAKE IMPORVEMENTS 

AND/OR CHANGES IN THE PRODUCT(S) AND/OR THE PROGRAM(S) DESCRIBED IN 

THIS PUBLICATION AT ANY TIME. 

BakBone Software 

10145 Pacific Heights Boulevard, Suite 500 San Diego, California 92121 858.450.9009

SECTION 1: 

The NDMP Plugin 

& the EMC 2 IP4700

abc

Chapter 1: 

The NDMP Plugin & the EMC 2 IP4700 

IG.0.0 - About the NDMP Plugin .................................................................................. 6 

• IG.0.1 - Terminology Used in This Guide ............................................................................... 6 

IG.1.0 - Target Audience ................................................................................................ 6 

IG.2.0 - Installing the NDMP Plugin........................................................................... 7 

• IG.2.1 - Installation Procedure............................................................................................... 7 

• IG.2.2 - Removing the NDMP Plugin...................................................................................... 8 

IG.3.0 - Configuration of the NDMP Plugin ............................................................ 9 

• IG.3.1 - The NDMP Server ..................................................................................................... 9 

- IG.3.1.a - Step 1: Verifying the NDMP Status......................................................................... 9 

- IG.3.1.b - Step 2: Checking Hardware .................................................................................. 9 

- IG.3.1.c - Step 3: Adding an NDMP Server.......................................................................... 10 

• IG.3.2 - Configuring Backup and Restore Log Filter Options ............................................... 12 

• IG.3.3 - Adding Devices for Use with the NDMP Plugin........................................................ 13 

IG.4.0 - Backing Up Data with the NDMP Plugin.............................................. 14 

• IG.4.1 - Backup Levels........................................................................................................ 15 

IG.5.0 - Restoring Data with the NDMP Plugin.................................................. 15 

• IG.5.1 - Restoring an Incremental Backup ........................................................................... 17 

• IG.5.2 - Renaming and Relocating a Restore ....................................................................... 19 

- IG.5.2.a - Renaming a Restore .......................................................................................... 19 

- IG.5.2.b - Relocating a Restore.......................................................................................... 20

6 

Chapter 1 


IG.0.0 

IG.0.1 

IG.1.0 

About the NDMP Plugin 

The NDMP Plugin for NetVault provides backup and restore capabilities to the 

EMC IP4700 using the Network Data Management Protocol (NDMP). It is 

designed for use on both Windows-based and UNIX/Linux-based operating 

systems. 

NDMP is an open protocol dedicated to data backups. It provides a way to 

integrate heterogeneous environments on networks to control and manage data 

flows. This protocol enhances backup performance by leveraging data transfer 

over the network as it standardizes the access to each component on the backup 

chain. 

The NetVault NDMP Plugin works with the EMC IP4700 to provide the following 

advantages: 

T 

T 

T 

Fast Indexing of the NAS Backup - This is an optimized post process which 

does not affect backup speed. 

Symmetrical Device Support - This allows an EMC IP4700 device, once 

added to NetVault, to be used just like any other NetVault device. 

Enhanced Indexing Options - Allows for more control. 

Terminology Used in This Guide 

Throughout this guide, references are made to various devices. It should be 

known that all of these terms refer to the same item: a library device attached to a 

machine within the NetVault domain that is to be used in an NDMP backup and 

restore strategy. They include: 

T 

T 

NDMP devices 

NAS devices 

T NDMP servers 

This guide also uses the term: 

T NDMP attached device - this refers to any tape devices (drives and libraries) 

that are attached to the NDMP server. 

Target Audience 

The NDMP Plugin is designed for use by administrators working with the EMC 

IP4700 device that has been successfully added to the NetVault Server for use 

(please see the NetVault Administrator’s Guide for complete details on adding 

devices to NetVault). An elementary knowledge of how a NAS device works and

NetVault Implementation Guide 

7 

IG.2.0 

IG.2.1 

Figure IG-1: 

The Client 

Management 

window of the 

NetVault GUI 

what it requires during backup and restore procedures is required to successfully 

configure and use this plugin. 

Installing the NDMP Plugin 

The NetVault NDMP Plugin must be installed on a NetVault Server. The software 

is installed and removed via the NetVault Client Management window. To install 

the plugin, follow the procedure explained on the following page. 

Installation Procedure 

1. Open the NetVault Client Management window by clicking the Client 

Management button on the NetVault GUI (or select Client Management 

from the Administration pull-down menu). 

2. Right-click on the NetVault Server in the Clients list. 

3. Choose 

Install 

Software 

from the popup 

menu (as 

shown in the 

figure on the 

following 

page). 

4. Navigate to 

the location 

of the 

NetVault 

“.npk” 

installation 

file (e.g. a 

NetVault 

APM/Plugin 

Installation 

CD or the 

directory to which the file was downloaded). Open the directory and choose 

the ndmxxxx.npk plugin file to install the plugin. 

5. Click Open and the software installation process will begin.

8 

Chapter 1 


Note: Based on the operating system being used, the directory path for this software may 

vary, but the file required for installation of this plugin should be entitled “ndmxxxx.npk” 

(where “xxxx” represents various software platforms and version numbers). 

Figure IG-2: 

The 

Confirmation 

dialog box that 

appears after a 

successful 

installation on 

a Windowsbased 

machine 

IG.2.2 

Figure IG-3: 

The Remove 

Software 

window with 

the NDMP 

Client Plugin 

selected for 

removal 

6. When the installation has completed, a 

successful installation message will 

appear in the Install Software dialog 

box. 

7. Installation is now complete and 

configuration of the plugin can now be 

performed. 

Removing the NDMP Plugin 

1. Access the Client Management window as described in the installation 

procedure above. 

2. Right-click on the NetVault Server in the Clients list to reveal the pop-up 

menu and select Remove Software. 

Figure IG-4: 

The two dialog 

boxes issued 

during the 

removal 

process for 

this Plugin 

3. Select the NDMP Client Plugin item from the displayed list and click the 

Remove button. 

4. A dialog box will appear asking for 

confirmation of the remove command. 

Click on OK to proceed (or Cancel to 

abort). Clicking OK results in the removal 

of the software and a confirmation 

message will appear. Click OK to close 

this dialog box and return to the Client 

Management window.


9 

IG.3.0 

IG.3.1 

IG.3.1.a 

Configuration of the NDMP Plugin 

Various configuration steps must be performed in order to properly set up the 

NDMP Plugin for use with an EMC IP4700 Device before backups and restores 

can be performed. The follow sections detail all of these necessary configurations. 

The NDMP Server 

It is first necessary to perform configuration operations on machine acting as the 

NDMP Server. Below are detailed instructions regarding this primary configuration 

and the addition of an NDMP Server. 

Step 1: Verifying the NDMP Status 

Prior to adding an IP4700 File Server to the NDMP Plugin, it is necessary to verify 

that the IP4700 NDMP license has been installed. Otherwise, NetVault will not be 

able to detect an NDMP attached library. This information can be accessed via the 

“About” utility of EMC’s IP4700 Administrative GUI Software. 

Note: For complete details on the use of the IP4700 Administrative GUI Software, please 

see the relevant EMC documentation. 

IG.3.1.b 

Step 2: Checking Hardware 

In order to properly add the NDMP server, the user must know the device nodes 

(e.g. c0 - Card; b0 - Bus Location of the SCSI Card; t0 - Target (SCSI ID); d0 - 

LUN (Logical Unit Number)) of the attached tape drives and libraries. These 

device nodes can be determined through the use of the “Tape Drives” utility of 

EMC’s IP4700 Administrative GUI Software. 

Note: For complete details on the use of the IP4700 Administrative GUI Software, please 

see the relevant EMC documentation.

10 

Chapter 1 


IG.3.1.c 

Figure IG-5: 

Right-click the 

NDMP Server 

and choose 

Add Server to 

open the 


dialog box 

Step 3: Adding an NDMP Server 

To add an NDMP Server to the NDMP 

Plugin, follow these steps: 

1. Open the Backup window by clicking the 

Backup button on the toolbar or by 

choosing the Operations Backup 

command. 

2. Right-click the NDMP Plugin and 

choose Add Server to open the initial 

NDMP Server dialog box (at first launch 

of the plugin, double-clicking on it will 

also bring up this dialog box). 

3. Enter the required information in the 

appropriate boxes. 

T Name: The name of the NDMPenabled 

NAS device. This name will 

be how NetVault recognizes the device in the future and it can be anything 

desired, but it is recommended that relevant be used. 

T Address(es): One or more IP addresses to the NDMP-enabled NAS 

device, separated by commas. 

T Port: The NDMP Server port number. 

T Account: The account of the user for the NDMP backup and restore. 

T Password: Password for the Account number (should be no more than 8 

characters). 

4. Click on OK to submit. The NDMP Plugin will then attempt to make contact 

with the device in order to define its type. 

5. A second dialog box will appear requesting additional information. Additional 

fields will be displayed for input.


11 

Figure IG-6: 

The initial and 

secondary 


dialog boxes 

T 

T 

T 

T 

T 

T 

Name: This value cannot be edited. The name input in the initial window 

will be displayed here. 

Address(es): One or more IP addresses to the NDMP-enabled NAS 

device (multiple addresses need to be separated by commas). The 

previously input address(es) should be displayed in this field. Edit the 

values in this field if necessary. 

Port: The NDMP server port number. The previously input value should 

be displayed in this field. Edit this value if necessary. 

Account: The account of the user for the NDMP backup and restore. The 

previously input value should be displayed in this field. Edit this value if 

necessary. 

New Password: The value for the password has been associated with 

the previously input account name, so the previously chosen Name will be 

displayed. If a new password is desired, click the checkbox in order to 

activate the field and input a new value as desired. Note that this 

password must be valid in regards to the account name given (as 

previously mentioned, this should be no more than 8 characters). 

Arm(s): The exact path to the device node for any locally attached library. 

Multiple paths for multiple nodes can be input. Separate multiple values in 

this field with a comma. This information can be obtained using the 

instructions detailed in the section Step 2: Checking Hardware on page 9.

12 

Chapter 1 


IG.3.2 

Figure IG-7: 


NDMP Plugin 

and choose 

Configure to 

open the 

Configure 

dialog box 

T Tape Drive(s): The exact path to the device nodes for any locally 

attached drive. Multiple paths, for multiple nodes can be input. Separate 

each value in this field with a comma. To locate a drive to identify these 

details, see the section Step 2: Checking Hardware on page 9. 

6. With all values properly input, click OK. If all information is valid, the NDMP 

Server will be added. 

Configuring Backup and Restore Log Filter Options 

To configure these options, use the following 

steps: 

1. Open the Backup window by clicking 

the Backup button on the toolbar or by 

choosing the Operations Backup 

command. 

2. Right-click the NDMP Plugin and 

choose Configure (as shown in the 

figure at right). 

3. The Configure dialog box will open, 

containing two tabs (see the figures 

below). 

T NDMP Backup Log Filters: Entries 

made in one or more of the Filter 

edit boxes prevents log messages 

with those characters from appearing in the backup job log files. 

T NDMP Restore Log Filters: Entries made in one or more of the Filters 

edit boxes prevents log messages with those characters from appearing 

in the restore job log files. When performing a restore an error message is 

produced for every file overwritten. This can quickly add up to thousands 

of messages, causing system degradation. The first Filters edit box in the 

NDMP Restore Log Filters tab contains the phrase “Warning cannot 

create directory” which automatically eliminates this type of error 

message.


13 

Figure IG-8: 

The two tabs in 

the Configure 

dialog box 

IG.3.3 

Adding Devices for Use with the NDMP Plugin 

Devices for use with the NDMP Plugin are configured in much the same manner 

as a standard device used with NetVault. For complete instructions on adding a 

storage device to the NetVault Server in order to backup and restore NDMP data, 

please see Appendix A: Storage Device Configuration on page 25 of this guide. 

Note: Prior to adding a device, the configuration steps outlined in the previous sections 

must take place.

14 

Chapter 1 


IG.4.0 

Figure IG-9: 

Select the 

NDMP Plugin, 

right-click and 

choose Open 


menu 

Figure IG-10: 

The NDMP 

Backup 

Request dialog 

box 

Backing Up Data with the NDMP Plugin 

To perform a backup using the NDMP Plugin, follow these steps: 

1. Open the NetVault Backup window by 

clicking the Backup button on the 

command toolbar or by choosing the 

Operations Backup command. The 

NetVault Backup window displays the 

list of clients in the Selections tab. 

2. Select the NDMP Plugin, right-click and 

choose Open from the pop-up menu (or 

double-click the plugin to display the list 

of clients. 

3. If this is the first time the plugin has 

been opened, the NDMP Server dialog 

box opens and the server information 

must be supplied. For more information 

on how to add a server, see the section 

The NDMP Server on page 9. 

4. Right-click on the NDMP Server and select Open from the pop-up menu. 

5. The NDMP Backup Request 

dialog box will launch. Enter the 

required information and select 

the desired options: 

T Directory: The full path of 

the data tree to be backed 

up. 

T Save File Information 

(Default Selected): When 

selected, this option allows for the restore of individual items contained 

within a backup. De-selecting this item creates a single backup item that 

must be fully restored (no individual restore of items contained within the 

backup is possible). 

T Backup Level: A number from 0-9, where 0 is a Full backup and 1-9 are 

levels of an incremental backup. See the the section Backup Levels on 

page 15 for more details on the use of this option. 

T Fast Incremental: When selected, this option prompts NetVault to use 

the IP4700’s Fast Incremental utility which monitors and flags directories 

in which files have been modified. Once started, the backup session will 

then only look to these flagged directories for modified files to backup (for 

complete details on this utility, please see the relevant IP4700 

documentation).


15 

Figure IG-11: 

The Job Title 

box 

IG.4.1 

T Snap Shot: When selected, this option prompts NetVault to employ the 

IP4700’s Snapshotting utility. This utility will create a point-in-time 

“snapshot” of the file system without disrupting user access or any 

modifications currently happening to that file system (for complete details 

on this utility, please see the relevant IP4700 documentation). 

6. Backup Options Tab - There are no Backup Options available for use with 

this plugin. 

7. All other tab selections (e.g. Schedule, Target and Advanced Options) 

function the same as a standard NetVault Backup (for more information on 

these options, please see the NetVault Administrator’s Guide). 

8. Input an appropriate title for the 

job in the Job Title box. 

9. Begin the job by clicking on the 

Submit button. 

Backup Levels 

Backup Levels refer to the type of backup being performed: 

T 

T 

Backup Level 0 - Set to this level (default), a Full Backup will be executed. 

Backup Level 1 - Set to level 1, an Incremental Backup will be performed, 

backing up only data that is new since the last Full Backup (Backup Level 0) 

T Backup Level 2 - Set to Level 2, an Incremental Backup will be performed, 

backing up only data that is new since the last Incremental Backup - In this 

case the backup that was performed, set to Backup Level 1. 

T Backup Level 3 - Set to Level 3, an Incremental Backup will be performed, 

backing up only data that is new since the last Incremental Backup - In this 

case the backup that was performed, set to Backup Level 2. 

This progression then continues with each level of the backup set (Backup Level 4 

will conduct an Incremental backup of data new since Backup Level 3, and so on, 

up to 9). 

Note: Only one backup at a level is remembered. If, for example a Level 1, 2, and 3 backup 

had been processed, and the Backup Level is then reset to Level 0 (conducting a Full 

Backup), the previous Backup Levels will then be invalidated. 

IG.5.0 

Restoring Data with the NDMP Plugin 

To perform a restore using the NDMP Plugin, follow these steps: 

1. Open the NetVault Restore window by clicking the Restore button on the 

command toolbar (or by choosing the Restore command from the 

Operations pull-down menu). The NetVault Restore window will display a 

list of clients that have restorable data.

16 

Chapter 1 


2. Right-click on the desired client and choose Open from the pop-up menu (or 

double-click the client name) to display a list of the plugins which have data 

available to be restored. 

3. Right-click on the NDMP Plugin in order to open it and display the backup 

savesets present on the selected NDMP client. 

4. Open the desired backup saveset (by double-clicking on it) and select the 

individual data items desired for a restore (as shown in the figure on the 

following page). 

Note: If the option Save File Information was de-selected prior to completing the backup, 

it will only be possible to select a complete backup saveset for a restore. 

Figure IG-12: 

Open the 

desired 

backup 

saveset and 

select the 

individual data 

items desired 

for a restore 

Figure IG-13: 

The options 

available in the 

Restore 

Options tab 

5. With the desired items selected for a restore, click on the Restore Options 

tab to display the options available for use with the NDMP Plugin (as shown 

in the figure at right). The following options can be set from this tab: 

T NDMP Server: 

The pre-assigned 

NetVault name for 

the NDMP server. 

By default this is 

the server the data 

was backed up 

from, but it is possible to specify another server in order to redirect the


17 

T 

restore, if desired. Note that the server to be used for a redirected restore 

must first be successfully added. For more information, see the section 

The NDMP Server on page 9. 

Log File Information: With this option selected, every file restored will be 

included in the log. 

Note: With this option active, large restores could result in very large log files that require 

long periods of time to access. 

T Incremental Restore: Select this option in order to complete a restore 

from an incremental backup (i.e. one performed using the Backup Level 

option from the Backup Options tab). For complete information on 

Restoring using this option, please see the section Restoring an 

Incremental Backup on page 17. 

6. All other tab selections (e.g. Target Client, Schedule and Advanced 

Options) function the same as a standard NetVault Restore. For more 

information on these options, please see Chapter 4: The Restore Window of 

the NetVault Administrator’s Guide. 

7. Input an appropriate title for the job in the Job Title box. 

8. Begin the job by clicking on the Submit button. 

IG.5.1 

Restoring an Incremental Backup 

Backups performed using the Backup Level settings (as discussed in the section 

Backup Levels on page 15) constitute the elements of an Incremental Backup. To 

complete a full restore of an Incremental Backup, it is necessary to conduct an 

individual restore with the Incremental Restore option selected from the Restore 

Options tab, for each level of the dump performed. 

The steps below outline an example of the restore process for an Incremental 

Backup that was performed through to Backup Level 3. 

Figure IG-14: 

The 

Incremental 

Restore option 

1. With a series of Incremental Backups performed through to Backup Level 

3, to fully restore data to the most recent Backup Level, it is necessary to 

first perform a restore of the backup that was performed at Backup Level 0. 

2. With the desired data selected from the backup 

saveset created for this level of the backup (i.e., 

Backup Level 0), select the Restore Options tab 

and select the Incremental Restore option. 

3. Assign an appropriate name to the job in the Job Title field (e.g., “Backup 

Level 0 Restore”) and click on the Submit button to run this first phase of 

the recovery. 

4. Follow this same procedure, selecting the same data as the previous level 

restore from the backup saveset that belongs to the Backup Level 1 job. 

Again, select the Incremental Restore option from the Restore Options

18 

Chapter 1 


window; assign an appropriate name for this level of the restore (e.g., 

“Backup Level 1 Restore”) and Submit the job. Incremental data from this 

phase of the backup will be restored over the first phase restore to bring the 

data up to the point in time the Backup Level 1 was performed. 

5. This same methodology would be followed, for each subsequent Backup 

Level, culminating with Backup Level 3. With this Backup Level restored, 

the data should be restored to the most recent state. 

Note: In support of incremental restore policy, if a Backup Level X backup is performed that 

includes a specific data item and then that data item is later deleted from the target system, 

all future Backup Level backups will not include that item. As well, restoring a later Backup 

Level than the one that originally included the data item will result in the deletion of that data 

item from the system. It is also important to note that this principle only applies if data items 

are added or removed, not changed. The example below illustrates this process: 

Example: 

1. Backup Level 0 is performed, backing up all files on a system (which consist of “data- 

1.txt” and “data-2.txt”). 

2. The file “data-3.txt” is added to the system by a user and the previous two files are left 

unmodified. A Backup Level 1 incremental backup is performed, which only includes this 

new file, “data-3.txt”, in the backup. 

3. The file “data-3.txt” is no longer need by the user and is therefore deleted from the 

target system. The user then adds a new file, “data-4.txt” and no modifications are made 

to the other existing files (i.e., “data-1.txt” and “data-2.txt”). A Backup Level 2 

incremental backup is performed. At this phase of the incremental scheme, only the file 

“data-4.txt” would be included in the backup. 

4. The system is lost, and it is now necessary to recover it to its most recent state. A restore 

of Backup Level 0 is performed first, creating the files “data-1.txt” and “data-2.txt”. 

5. A restore of the next level of the incremental backup, Backup Level 1 is then performed 

and the file “data-3.txt” is recovered and added to the other two previously restored files. 

6. The next incremental backup in the series (i.e., Backup Level 2) is then restored. As 

noted in Step 3, the “data-3.txt” file was deleted by the user prior to tis level of the 

incremental backup, so in recovering Backup Level 2, the file “data-3.txt” will be deleted 

from the restore location and the file “data-4.txt” would be added. 

7. The end result being the recovery to the system of the files “data-1.txt”, “data-2.txt” and 

“data-4.txt”. 

If any of the aforementioned files were to have changed (not simply added or deleted) this 

principle would not apply, (e.g. “data-1.txt” has changed throughout this process. Recovering 

an older Dump (Dump Level 1) would overwrite the newer “data-1.txt” file recovered with 

Dump Level 2).


19 

IG.5.2 

IG.5.2.a 

Renaming and Relocating a Restore 

Renaming a Restore 

It is possible to rename backup saveset data when restoring it with the NDMP 

Plugin. Upon successful restore, the data will be recovered to its original location, 

but with a different name. This is helpful in the event that an existing item is to 

remain and not be overwritten by the restored data. 

Note: Only entire directories can be renamed and/or relocated. Individual items contained 

within must remain in the directory and must maintain their existing name(s). 

Figure IG-15: 


desired item 

and choose 

Rename to 

bring up the 

Restore 

Rename 

dialog box 

1. From the Selections window, open down to the appropriate backup saveset. 

2. Open the backup saveset (by double clicking on it). 

3. Right-click the desired item and choose Rename from the pop-up menu. The 

Restore Rename dialog box will appear. 

Figure IG-16: 

The rename/ 

relocate is 

displayed with 

the selected 

data 

4. To rename the item, select the 

Rename to option and enter the 

new name for the directory being 

restored (in the example above, 

the directory will be renamed from 

“data” to “data1”).

20 

Chapter 1 


5. Click OK to commit the change and return to the Restore window. The 

rename/relocate will be displayed with the selected data (as shown in the 

figure above). 

6. Continue with normal restore selections and options (as described in the 

section Restoring Data with the NDMP Plugin on page 15) and then submit 

the job. 

IG.5.2.b 

Figure IG-17: 

To relocate an 

item, select the 

Rename 

option and 

enter the new 

location for the 

directory being 

restored 

Relocating a Restore 

NetVault’s NDMP Plugin allows for relocation of an item from one storage 

processor to another on the EMC IP4700. This can be helpful when the original 

processor is down or when dealing with limited bandwidth or capacity. 

1. Follow steps 1-3 as detailed in the section Renaming a Restore on page 19. 

2. To relocate the item, select the Rename option and enter the new location for 

the directory being restored (in the example above, the directory “data” will 

be relocated from “/A0” to “/B0”).


21 

Figure IG-18: 

The relocate is 

displayed with 

the selected 

data 

Figure IG-19: 

The NDMP 

Server field 

3. Click OK to commit the change 

and return to the Restore 

window. The relocate will be 

displayed with the selected data 

(as shown in the figure at right). 

4. Select the Backup Options tab. 

5. In the NDMP Server field, input 

the name of the alternate NDMP 

Server that controls the storage processor that the file is to be relocated to 

(as shown in the figure below). 

6. Continue with normal 

restore selections 

and options (as 

described in the 

section Restoring 

Data with the NDMP 

Plugin on page 15) 

and then submit the job. 

Note: It is also possible to Rename an item being relocated. In the Rename to field of the 

Restore Rename dialog box, simply input the new name after the relocated directory 

(separated with a “/”). The resulting item will be restored with a new name in the new 

directory (e.g. An item “data” is to be renamed “data1” and relocated from “/A0” to “/B0.” 

Therefore, the value input would be “B0/data1”). This process must be followed to 

successfully rename a directory that is to be restored (i.e. Input the rename as detailed 

above and do not use the standard Rename function described in the previous section).

22 

Chapter 1 

The NDMP Plugin & the EMC 2 IP4700

SECTION 2: 

Appendix

abc

Appendix A: 

Storage Device Configuration 

A.0.0 - Storage Devices and the NDMP Plugin - An Overview..................... 27 

A.1.0 - Adding a Storage Device to NetVault....................................................... 27 

• A.1.1 - Device Addition Pre-Requisites ............................................................................... 28 

• A.1.2 - The Phases of NetVault Device Addition - An Overview............................................ 28 

• A.1.3 - Phase 1: Automatic Device Configuration................................................................ 28 

- A.1.3.a - Step 1: Initiating Automatic Device Configuration ................................................... 29 

- A.1.3.b - Step 2: Adding and Configuring the Device............................................................ 30 

- A.1.3.c - Step 3: Final Confirmation of an Added Device ...................................................... 32 

• A.1.4 - Phase 2: Manually Initiating Automatic Device Configuration................................... 32 

• A.1.5 - Phase 3: Manually Adding a Device ......................................................................... 33

26 

Appendix A 

Storage Device Configuration


27 

A.0.0 

Storage Devices and the NDMP Plugin - An 

Overview 

When developing a backup and restore strategy for NDMP data, one of the most 

important factors to take into consideration is the physical set up of the storage 

network that is to handle this operation. Even though there is a myriad of possible 

combinations for this network, two basic examples can be looked to accomplish 

this end: 

T 

T 

Directly Attach a Storage Device to the NAS Device (within a SAN) - The 

beauty of a NAS device is that a library can be directly attached to it and 

backups and restores can be sent directly to this device from the NAS device, 

thereby eliminating network traffic hold-ups. Adding devices of this 

configuration to the NetVault Server is much the same as adding a standard 

device, with a few minor changes. Directions for this procedure are fully 

covered in this Appendix. 

Use a Device Attached to a Client Machine in the Network (Outside of a 

SAN) - In rare instances, it may be necessary to utilize a storage device 

attached to a client machine, rather than the NAS device. To accomplish this, 

a device is directly attached to a client machine (which is then added to the 

NetVault Server via the Client Management window) or to the NetVault Server 

itself. This machine must exist within a network that is accessible to the NAS 

device for backups/restores to occur. Adding this device for use in NetVault 

would be performed using the standard device addition instructions. 

Important Notes: 

1. While either (or both) of these configurations are possible to conduct backups and 

restores of NDMP data from a NAS device, it is strongly recommended that the former be 

utilized. While the latter will work, it may result in much longer backup/restore times as 

network traffic will be greatly increased as will usage of the resources of the client 

machine hosting the attached storage device. 

2. Instructions for the standard addition of a storage device (i.e. as covered in the latter point 

above) are not offered in this Appendix. Please see Chapter 7: Device Management of 

the NetVault Administrator’s Guide for complete details on this process. 

A.1.0 

Adding a Storage Device to NetVault 

The following sections cover the requirements for adding a storage device to 

NetVault that exists within a SAN environment (i.e. it is directly attached to the 

NAS device). In this case, a library attached to an EMC IP4700 is to be added to 

the NetVault Server for use in a backup/recovery strategy.

28 

Appendix A 


A.1.1 

A.1.2 

A.1.3 

Device Addition Pre-Requisites 

Prior to attempting to add a storage device of this configuration to NetVault, the 

following must be performed: 

T 

T 

T 

The Storage Device Must be Connected to the NAS Device and Properly 

Configured - The device must be properly connected and any internal 

configuration on the NAS device required to allow for use of the device must 

be performed. Please see any relevant product documentation for the EMC 

IP4700 for details on any of these procedures. 

Media Must be Loaded in All Drives - In order to add a library’s drive for 

use by NetVault, there must be a tape loaded in that drive. In the event that 

multiple drives exist within the library, each drive must have a tape loaded. 

The “NDMP Server” Established and Successfully Configured - All of the 

steps covered in the section The NDMP Server on page 9 of this guide must 

be performed before attempting to add the device to NetVault. 

The Phases of NetVault Device Addition - An Overview 

In a sense, storage devices are added to NetVault in a series of “phases” based on 

the device and its capacities. Below, a brief outline is given for each of these 

phases. 

T 

T 

T 

Phase 1: Automatic Device Configuration - If configuration of the NDMP 

Server has been performed properly and the storage device to be added is 

capable of serialization, NetVault will automatically detect the device and 

begin a step-by-step configuration of the device 

Phase 2: Manually Initiating Automatic Device Configuration - While 

some devices may meet all of the requirements for Phase 1, the network 

configuration of the SAN environment may interfere with the automatic 

recognition of the device. Therefore, it is possibly to initiate a command that 

forces NetVault to search the network for a device. 

Phase 3: Manually Adding the Device - Devices that are not capable of 

serialization will not be automatically recognized by the Automatic Device 

Configuration Utility, and therefore must be added manually. This accounts 

for some older devices but manual addition may also be required based on 

the SAN configuration. 

Phase 1: Automatic Device Configuration 

As noted above, the first phase of storage device addition in NetVault is its 

Automatic Device Configuration utility. Upon launching the Device Management 

window in the NetVault GUI, a scan will be conducted of the network. If any eligible 

devices are found, NetVault will launch a “Wizard” allowing for configuration of the 

device. This process also works if a new, eligible device is added in the future..


29 


1. If running Microsoft Windows 2000, the operating system must be configured prior to 

installing the NetVault Software. For details, please see Chapter 2: NetVault Installation 

Procedures of the NetVault Administrator’s Guide. 

2. If any additional client machines within the SAN are to be backed up to the storage device 

as well, the Client version of NetVault must be installed on each and once this is 

complete, it is recommended that all of these clients be added to the NetVault Server prior 

to initiating Automatic Device Configuration (i.e., do not access the Device Management 

window of the NetVault GUI before performing the aforementioned). This way, the device 

will be automatically configured for use by all of these NetVault Clients. 

A.1.3.a 

Figure A-1: 

The Device 

Configuration 

wizard 

Step 1: Initiating Automatic Device Configuration 

1. Launch NetVault and click on either of the Device Management buttons in 

the command toolbars (or select the Device Management command from 

the Administration pull-down menu). The software will then automatically 

scan the local machine (the NetVault Server) and the network of added 

NetVault Clients for attached devices. 

2. Devices capable 

of serialization 

that are found 

within the 

NetVault Domain 

will be 

recognized (e.g., 

in the case of a 

library device, 

this indicates that 

it is capable of 

telling a user 

which drives are 

in which drive 

bays) or attached 

directly to the NetVault Server itself. 

3. As an applicable device is located, the Device Configuration “Wizard” will 

launch and detailed information on it will be offered in the first window. This 

includes information such as the name of the NetVault Server which 

administers the domain that this device is housed in (i.e. 

4. To begin configuration of the device, click on the 

Yes button. To avoid configuration for this 

specific device, select No. If “No” is selected, 

each time NetVault is loaded, and the Device Management window 

accessed, the Wizard will recognize this device and prompt the user to

30 

Appendix A 


configure it again, unless the Do not ask again for this device box is 

checked. 

A.1.3.b 

Figure A-2: 

The Name 

field of the 

second 

window of the 

Wizard can be 

used to put in 

a custom 

name value for 

the device 

Figure A-3: 

The additional 

options made 

available in the 

Add Library 

window once 

the Scan for 

Remote/ 

Shared Drives 

option is 

selected 

Step 2: Adding and Configuring the Device 

1. From the second 

window of the 

wizard, the 

Name field will 

initially display 

the path to the 

library, in regards 

to the NetVault 

Client it is 

attached to as 

well as a name 

value based on 

the library type 

being added. This value can be changed to any desired name in order to 

more easily differentiate this device once added (e.g. the value 

“NDMP_Library” has been used for this example). 

2. The default performance options can be changed by selecting Configure 

Performance Options. Selecting this and then clicking Next will reveal an 

additional window for custom configuration (see the section Configuring 

Performance Options on page 31 for complete details on the options 

available in this window). 

3. Selecting the Scan 

Clients for Remote/ 

Shared Drive option 

will expand the Add 

Library window to 

include additional 

options in this window 

which allow for various 

options to be set for 

use in setting up a 

library’s drives as 

shared, including the 

following: 

T Re-scan clients 

for devices: It is 

possible that the information gathered automatically by NetVault when 

initially auto detecting devices is out of date. Selecting this item will force a 

re-scan of the bus, rather than using the cached, original information.


31 

T Select Clients Window. This window displays a list of available clients. 

Select any or all of the clients listed that may have a device attached. 

NetVault will scan the selected clients and if a device is found, it will 

automatically add it to the client as part of the SAN attached library. 

4. With all options set as desired, click Next to proceed. 

Configuring Performance Options 

Figure A-4: 

The options 

made 

available once 

Configure 

Performance 

Options is 

selected from 

the Add 

Library window 

(and the Next 

button used) 

If Configure Performance 

Options was selected from 

the Add Library window, this 

window will appear offering 

additional options that can 

be set for the configuration of 

the added device, including 

the following: 

T 

T 

Amount of memory to 

assign to transfer 

buffers (Kb): Often 

referred to as the shared 

memory setting, this 

allows the user to set the 

size of the buffer for 

transfer. The default of 257 which is the minimum shared memory size, is 

equal to 8 buffers of 32 Kb plus one Kb. Increasing this value will optimize 

performance, if available memory will allow. 

Media Block Size: Increasing this value may increase the backup 

performance on various types of devices. 


1. If the Media Block Size value is increased, the shared memory setting must be 

increased as well. The value of the shared memory setting must be equal to at least four 

times the Media block size plus one (in Kb). 

2. Configuring total shared memory size also depends on the operating system being used. 

Always use caution when setting block size and shared memory size on a system.

32 

Appendix A 


A.1.3.c 

Figure A-5: 

The following 

window 

appears after 

NetVault has 

scanned the 

SCSI bus and 

successfully 

added the 

device(s) 

A.1.4 

Step 3: Final Confirmation of an Added Device 

Once NetVault has scanned the 

network and successfully 

added the device, the following 

window will appear. 

1. To exit and complete this 

operation, click Finish. 

The device will be 

successfully added and, 

after it is scanned for 

devices (i.e., a dialog box 

will launch stating that the 

device is being scanned) it 

will appear in the Devices tab of the Device Management window. 

Phase 2: Manually Initiating Automatic Device 

Configuration 

In the event that a device capable of serialization was not recognized by 

NetVault’s Automatic Device Configuration (i.e. the “wizard” did not automatically 

launch when the Device Management window was accessed), it may be 

necessary to manually launch this utility. To do so, follow the steps below: 

Note: In order to scan for Standalone drives (e.g. single tape drives directly attached to the 

NetVault Server or Pseudo-drives), this procedure must be followed. 

Figure A-6:. 

Select Auto- 

Configure 

Device from 

the Add pulldown 

menu 

1. From the NetVault Device Management window, with the Devices tab 

selected, select Auto-Configure Device from the Add pull-down menu. 

2. From the Automatic Device Configuration window that appears, the 

following options are available: 

T Select Device Type Frame: Select the type of device desired (Library or 

Standalone Drive) by clicking the appropriate radial button. In this 

example, a library device is attached to the NAS device, so the Library 

option would be selected.


33 

Figure A-7: 

The options 

available from 

the Automatic 

Device 

Configuration 

window 

Figure A-8: 

The Clear list 

of ignored 

devices option 

T 

T 

T 

Select Client Frame: A 

list of available clients is 

displayed in this frame. 

Select the NetVault 

Client to be searched 

here. In this example, the 

NDMP Server was 

configured using the 

instructions covered in 

previous sections of this 

guide and it was given 

the name 

“NDMP_SERVER”. 

Therefore, this is the 

client that would be 

selected from this frame. 

Re-scan for devices: It is possible that the information gathered 

automatically by NetVault when initially auto-detecting devices may be out 

of date. Selecting this item will force a re-scan of the bus, rather than 

using any cached, original information. 

Clear list of ignored devices: By 

right-clicking on a client in the 

Select Client Frame, a pop-up 

menu is accessed with this option. 

This option is selected if during the 

initial automatic configuration 

performed from the NetVault Server, the Do not ask again for this 

device checkbox was selected. This will refresh the list and allow 

previously ignored devices to be automatically recognized. 

Note: This options can only be accessed for clients that have already been selected in this 

frame (i.e. the client’s checkbox is marked with a green check). 

A.1.5 

3. With all options set as desired, click Next to proceed. 

4. If a device is found on the selected client(s), the Automatic Device 

Configuration wizard will launch. The procedure covered in the section Phase 

1: Automatic Device Configuration on page 28 can be used to successfully 

add the device once recognized. 

Phase 3: Manually Adding a Device 

In the event that Automatic Device Configuration was unable to locate the desired 

device for addition via either of the two previous phases, the device will need to be 

added to the NetVault Server manually. This may be the result of the complexity of

34 

Appendix A 


the SAN configuration or the fact that the device in use is not capable of 

serialization. Regardless of the reason, this section can be used to add the device 

to the NetVault Server. 

NetVault allows for addition of devices that are either directly attached to the 

NetVault Server, or to a remote client, also known as a SmartClient TM . In this case 

the library attached to the NAS device would be viewed by NetVault as a 

SmartClient TM . In the example that follows, a library device, which contains two 

drives and is directly attached to a NAS device (i.e. an EMC IP4700) is to be 

added for use by NetVault. 

1. Open the NetVault Device Management window by clicking the Device 

Management button on one of the command toolbars (or by choosing the 

Device Management command from the Administration pull-down menu). 

Note: All configuration processes covered in the section The NDMP Server on page 9 of 

this guide must be performed before attempting to add a device as illustrated in the following 

example. Otherwise the device will not be revealed for addition. 

Figure A-9: 

The Add 

Library window 

and the 

2. Choose the Add Library command from the Add pull-down menu in order to 

to open the Add Library window. This window contains the following options: 

T 

T 

T 

Library Selection Tab - Displays the list of clients to which libraries are 

connected, and shows the libraries available to be added. 

Drive Selection Tab - Displays the list of clients to which drives are 

connected, and shows the drives available to be added. The correct drive 

for each library drive bay must be selected. 

Configure Tab: Displays an overview of the complete library 

configuration and allows additional configuration to be set up using library 

(armchanger) and drive pop-up menus.


35 

Figure A-10: 

The Save 

details button 

Figure A-11: 

Right-click and 

choose Open 


menu 

T 

Save Details Button - Once complete with the appropriate 

settings, click this button in order to save the Library 

configuration modifications. 

3. Select the client with the desired library attached in 

order to add it. For this example, a client that was 

created during configuration of the NDMP Plugin, 

entitled “NDMP_SERVER” has the locally attached 

device that is to be used. Therefore it is selected for 

this step. 

4. Right-click on the selected client and choose Open from the pop-up menu (or 

double-click on the client). The two available device types will be revealed, 

represented by folder icons -- Robotic Libraries and NDMP Robotic 

Libraries. Each will be automatically opened to reveal eligible devices of this 

type in their respective tree structures. 

Note: If a device is not revealed beneath either of these two folder icons, a device of that 

type is not currently available from the selected client. In the case of the NDMP Robotic 

Libraries icon, if this occurs for a client that was previous configured for the NDMP Plugin, 

that has a device directly attached, the configuration was not completed correctly. Review the 

configuration process (as illustrated in the section The NDMP Server on page 9) to ensure 

that it was performed properly. 

Figure A-12: 

Once selected, 

the library 

picture, Type, 

and Details are 

displayed in 

the Selected 

Library frame 

5. Since the desired device for this operation is directly attached to an NAS 

device (i.e. the EMC IP4700), it will be revealed beneath the NDMP Robotic 

Libraries folder icon. Right-click on this device and choose Select from the 

pop-up menu. 

6. Once selected in 

this manner the 

library picture will 

appear in the 

Selected Library 

frame 

accompanied by 

library-specific 

information in the 

Type drop-down 

list and Details 

field. In addition, 

NetVault normally 

displays an ID 

and device string 

for the library 

(armchanger) in the Choose Library field.

36 

Appendix A 


Figure A-13: 

Right-click on 

the desired 

NetVault Client 

and select 

Open from the 

pop-up menu. 

Then select 

the desired 

drive, rightclick 

and 

choose Select 


menu 

Figure A-14: 

Adding the first 

drive in a 

multiple drive 

library 

7. With the library device successfully selected, click the Drive Selection tab to 

continue. 

8. In the Choose Drive frame, right-click on the same NetVault client that was 

accessed in the previous tab (e.g. “NDMP_SERVER”), and select Open 

from the pop-up menu (or simply double-click on the client). 

9. A complete list of 

currently available drives 

will be revealed beneath 

their drive type folder in 

the tree structure. This 

includes all available 

drives, not just those in 

the device that was 

selected in the previous 

tab. Therefore, if 

additional devices are 

attached to the NAS device, their 

drives will be revealed here as well. 

Based on the drive information 

enclosed in parenthesis next to each available drive, locate the specific 

drives associated with the selected device in order to select them for 

10.If multiple drives exist in a single library, each drive must be assigned to its 

correctly numbered Drive Bay. In this example, the library to be added 

contains two drives. Drive one must be assigned to Drive Bay one and drive 

two must be assigned to Drive Bay two. The following steps were taken to 

successfully set up these drives: 

a. To begin, a 

value of one 

(“1”) was 

input in the 

Select for 

Drive Bay 

field 

b. Drive one was then right-clicked on in the Choose Drives field and the 

Select command was chosen from the pop-up menu, establishing Drive 

Bay one as the location of this drive. Once selected, a picture of the 

selected drive will appear in the Selected Drives frame along with 

information pertain to that drive type.


37 

Figure A-15: 

Adding the 

second drive in 

a multiple drive 

library 

c. For the 

second drive, 

two (“2”) 

was input in 

the Select 

for Drive 

Bay field. 

d. Lastly, the 

drive serving as drive two was right-clicked on and the Select command 

chosen from the pop-up menu, establishing Drive Bay two as the location 

of this drive. Again, once selected in this manner a picture of the added 

drive type will appear in the Selected Drives frame, accompanied by 

information pertain to that drive. 

Note: In the event that additional drives exist in the library, continue to add them in this 

same manner, ensuring that each drive number is selected for the correct Drive Bay (i.e. the 

correct number value is assigned in the Select for Drive Bay field prior to choosing the 

Select command from the pop-up menu). 

Figure A-16: 

Some of the 

basic options 

available from 

the Configure 

tab for both a 

library device 

and its added 

drives 

5. With all drives successfully added to the library device, the Configure tab 

can be accessed. This tab allows for advanced configuration of library and 

drive parameters. The options available in this tab are no different than those 

offered for a traditional device. For complete details on the use of these 

options, please see Chapter 7: The Device Management window of the 

NetVault Administrator’s Guide. 

Figure A-17: 

A custom 

name input for 

the library 

6. A default name for the library which 

includes the path to the client it is 

attached to (e.g. “NDMP_SERVER” in

38 

Appendix A 


Figure A-18: 

The NetVault- 

Information 

dialog 

Figure A-19: 

The NetVault 

Device 

Management 

window 

displays the 

newly added 

device 

this example) as well as information specific to the type of device will be 

displayed in the Library Name field. This is how the library will be displayed 

throughout NetVault. If this name is acceptable leave this value unchanged, 

otherwise input a desired new name in this field. 

7. With all previous steps completed and 

configuration options set as desired, click the 

Save Details button to save the library 

configuration. The NetVault - Information dialog 

will appear stating that the library has been added 

successfully. 

8. The NetVault 

Device 

Management 

window will 

now display 

the new 

device and 

initialization 

will begin. 

Initially, only 

the library and 

drive(s) are 

displayed. As 

each slot is 

initialized and media is located, it will initially reveal a media type title of 

UNKNOWN. Upon successful scanning of the entire library, media will then 

be given any one of the following labels, based on the results of the scan: 

T Blank: New or previously blanked media. 

T Foreign: Previously used NetVault media will be displayed with the Media 

Label originally assigned to it. FOREIGN: will precede this media if it is not 

recognized by the NetVault database. This media must be scanned for 

use. 

T NetVault5 NT (or other O/S): In the event that a piece of media was used 

with a version of NetVault earlier than 6.x, this label will be assigned to it. 

T Other: Media formatted in some other manner.

NDMP Implementation Guide (EMC).book

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

Delete template?

Save as template?