Symantec NetBackup

Administrator's Guide,
Volume I
UNIX, Windows, and Linux

Release 7.6.1

Symantec NetBackup Administrator's Guide,

Volume I
The software described in this book is furnished under a license agreement and may be used
only in accordance with the terms of the agreement.
Documentation version: 7.6.1

Legal Notice
Copyright 2014 Symantec Corporation. All rights reserved.
Symantec, the Symantec Logo, the Checkmark Logo and are trademarks or registered
trademarks of Symantec Corporation or its affiliates in the U.S. and other countries. Other
names may be trademarks of their respective owners.
This Symantec product may contain third party software for which Symantec is required to
provide attribution to the third party (Third Party Programs). Some of the Third Party Programs
are available under open source or free software licenses. The License Agreement
accompanying the Software does not alter any rights or obligations you may have under those
open source or free software licenses. Please see the Third Party Legal Notice Appendix to
this Documentation or TPIP ReadMe File accompanying this Symantec product for more
information on the Third Party Programs.
The product described in this document is distributed under licenses restricting its use, copying,
distribution, and decompilation/reverse engineering. No part of this document may be
reproduced in any form by any means without prior written authorization of Symantec
Corporation and its licensors, if any.
THE DOCUMENTATION IS PROVIDED "AS IS" AND ALL EXPRESS OR IMPLIED
CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED
WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR
NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH
DISCLAIMERS ARE HELD TO BE LEGALLY INVALID. SYMANTEC CORPORATION SHALL
NOT BE LIABLE FOR INCIDENTAL OR CONSEQUENTIAL DAMAGES IN CONNECTION
WITH THE FURNISHING, PERFORMANCE, OR USE OF THIS DOCUMENTATION. THE
INFORMATION CONTAINED IN THIS DOCUMENTATION IS SUBJECT TO CHANGE
WITHOUT NOTICE.
The Licensed Software and Documentation are deemed to be commercial computer software
as defined in FAR 12.212 and subject to restricted rights as defined in FAR Section 52.227-19
"Commercial Computer Software - Restricted Rights" and DFARS 227.7202, "Rights in
Commercial Computer Software or Commercial Computer Software Documentation", as
applicable, and any successor regulations. Any use, modification, reproduction release,
performance, display or disclosure of the Licensed Software and Documentation by the U.S.
Government shall be solely in accordance with the terms of this Agreement.

Symantec Corporation
350 Ellis Street
Mountain View, CA 94043
http://www.symantec.com
Printed in the United States of America.
10 9 8 7 6 5 4 3 2 1

Technical Support
Symantec Technical Support maintains support centers globally. Technical Supports
primary role is to respond to specific queries about product features and functionality.
The Technical Support group also creates content for our online Knowledge Base.
The Technical Support group works collaboratively with the other functional areas
within Symantec to answer your questions in a timely fashion. For example, the
Technical Support group works with Product Engineering and Symantec Security
Response to provide alerting services and virus definition updates.
Symantecs support offerings include the following:

A range of support options that give you the flexibility to select the right amount
of service for any size organization

Telephone and/or Web-based support that provides rapid response and

up-to-the-minute information

Upgrade assurance that delivers software upgrades

Global support purchased on a regional business hours or 24 hours a day, 7

days a week basis

Premium service offerings that include Account Management Services

For information about Symantecs support offerings, you can visit our website at
the following URL:
www.symantec.com/business/support/
All support services will be delivered in accordance with your support agreement
and the then-current enterprise technical support policy.

Contacting Technical Support

Customers with a current support agreement may access Technical Support
information at the following URL:
www.symantec.com/business/support/
Before contacting Technical Support, make sure you have satisfied the system
requirements that are listed in your product documentation. Also, you should be at
the computer on which the problem occurred, in case it is necessary to replicate
the problem.
When you contact Technical Support, please have the following information
available:

Product release level

Hardware information

Available memory, disk space, and NIC information

Operating system

Version and patch level

Network topology

Router, gateway, and IP address information

Problem description:

Error messages and log files

Troubleshooting that was performed before contacting Symantec

Recent software configuration changes and network changes

Licensing and registration

If your Symantec product requires registration or a license key, access our technical
support Web page at the following URL:
www.symantec.com/business/support/

Customer service
Customer service information is available at the following URL:
www.symantec.com/business/support/
Customer Service is available to assist with non-technical questions, such as the
following types of issues:

Questions regarding product licensing or serialization

Product registration updates, such as address or name changes

General product information (features, language availability, local dealers)

Latest information about product updates and upgrades

Information about upgrade assurance and support contracts

Information about the Symantec Buying Programs

Advice about Symantec's technical support options

Nontechnical presales questions

Issues that are related to CD-ROMs, DVDs, or manuals

Support agreement resources

If you want to contact Symantec regarding an existing support agreement, please
contact the support agreement administration team for your region as follows:
Asia-Pacific and Japan

[email protected]

Europe, Middle-East, and Africa

[email protected]

North America and Latin America

[email protected]

Contents

Technical Support ............................................................................................... 4

Section 1

About NetBackup

Chapter 1

Introducing NetBackup interfaces .................................. 34

....................................................... 33

About NetBackup .........................................................................

NetBackup documentation .............................................................
About NetBackup administration interfaces ........................................
About setting up the NetBackup Administration Console on
UNIX .............................................................................
About using the Java Windows Administration Console ..................
Administering remote servers of different versions .........................
Using the NetBackup Administration Console .....................................
Standard and user toolbars ......................................................
About customizing the NetBackup Administration Console ..............
NetBackup configuration wizards .....................................................
Running the Troubleshooter ...........................................................

Chapter 2

34
36
36
39
41
43
45
52
52
52
54

Administering NetBackup licenses .................................. 56

About administering NetBackup licenses ........................................... 56

Section 2

Configuring hosts ........................................................ 61

Chapter 3

Configuring Host Properties ............................................. 62

About the NetBackup Host Properties ...............................................
Methods to set the NetBackup configuration options ......................
Viewing host properties ...........................................................
Changing the host properties on multiple hosts at the same
time ...............................................................................
Property states for multiple hosts ...............................................
Exporting host properties .........................................................
Standard host property dialog box options ...................................
About configuring Indexing Servers ..................................................

64
67
68
68
69
71
71
72

Contents

Schedules properties .............................................................. 72

Access Control properties .............................................................. 74
Authentication Domain tab of the Access Control properties ............ 75
Authorization Service tab of the Access Control properties .............. 76
Network Attributes tab of the Access Control properties .................. 77
Active Directory host properties ....................................................... 80
Backup Exec Tape Reader properties ............................................... 82
Bandwidth properties .................................................................... 84
Bandwidth limit usage considerations and restrictions .................... 85
Add Bandwidth Settings dialog box for Bandwidth properties ........... 86
Busy File Settings properties .......................................................... 86
Activating the Busy File Settings in host properties ........................ 88
Clean-up properties ...................................................................... 89
Client Name properties .................................................................. 92
Client Attributes properties ............................................................. 93
Add Client dialog box .............................................................. 95
General tab of the Client Attributes properties .............................. 95
Connect Options tab of the Client Attributes properties ................. 100
Windows Open File Backup tab of the Client Attributes
properties ..................................................................... 102
Back-level and upgraded clients that use Windows Open File
Backup ......................................................................... 107
Client Settings properties for UNIX clients ........................................ 108
VxFS file change log for incremental backups property ................. 111
Client Settings properties for Windows clients ................................... 113
How to determine if change journal support is useful in your
NetBackup environment ................................................... 116
Guidelines for enabling NetBackup change journal support ........... 117
Credential Access properties ......................................................... 118
Data Classification properties ........................................................ 119
Creating a Data Classification ................................................. 121
Default Job Priorities properties ..................................................... 122
Understanding the Job Priority setting ....................................... 123
Distributed application restore mapping properties ............................. 125
Encryption properties ................................................................... 126
Additional encryption methods for Windows clients ...................... 129
Enterprise Vault properties ............................................................ 130
Enterprise Vault Hosts properties ................................................... 131
Exchange properties ................................................................... 132
About the Exchange credentials in the client host properties .......... 135
Exclude Lists properties ............................................................... 136
About the Add to exclude list and Add to exceptions list dialog
boxes ........................................................................... 139

Contents

Syntax rules for exclude lists ...................................................

About creating an include list on a UNIX client ............................
Configuring the exclude list on a Windows client from a UNIX
master server .................................................................
Traversing excluded directories ...............................................
Fibre Transport properties ............................................................
About Linux concurrent FT connections .....................................
Firewall properties ......................................................................
Enabling logging for vnetd ......................................................
General Server properties ............................................................
Forcing restores to use a specific server ....................................
Global Attributes properties ...........................................................
About constraints on the number of concurrent jobs .....................
Setting up email notifications about backups ..............................
Configuring the nbmail.cmd script on Windows ...........................
Sending messages to the global administrator about unsuccessful
backups only .................................................................
Sending messages to the administrator about successful and
unsuccessful backups .....................................................
Installing and testing the email utility on Windows ........................
Logging properties ......................................................................
Login Banner Configuration properties ............................................
Removing login banner screen and text .....................................
Enabling the Auto log off timeout option .....................................
Lotus Notes properties .................................................................
Media properties ........................................................................
Results when media overwrites are not permitted ........................
Recommended use for Enable SCSI reserve property ..................
NDMP Global Credentials properties ..............................................
Network properties ......................................................................
Network Settings Properties ..........................................................
Reverse Host Name Lookup property .......................................
IP Address Family Support property .........................................
Port Ranges properties ................................................................
Registered ports and dynamically-allocated ports ........................
Preferred Network properties ........................................................
Add or Change Preferred Network Settings dialog box .................
How NetBackup uses the directives to determine which network
to use ...........................................................................
Configurations to use IPv6 networks .........................................
Configurations to use IPv4 networks .........................................
Order of directive processing in the Preferred Network
properties .....................................................................

141
143
144
146
147
150
150
154
154
157
158
161
163
164
166
166
168
169
174
177
177
178
182
186
187
188
190
192
193
194
194
196
197
199
201
204
205
206

Contents

Order of directives can affect processing ...................................

bptestnetconn utility to display Preferred Network
information ....................................................................
Configuration to prohibit using a specified address ......................
Configuration that uses the same specification for both the network
and the interfaceless constrictive ....................................
Configuration that uses the same specification for both the network
and the interfacemore constrictive ...................................
Configuration that limits the addresses, but allows any
interfaces ......................................................................
Resilient Network properties .........................................................
Resilient connection resource usage ........................................
Specifying resilient connections ...............................................
Resource Limit properties .............................................................
Restore Failover properties ...........................................................
Assigning an alternate media server as a failover restore
server ...........................................................................
Retention Periods properties .........................................................
Changing a retention period ....................................................
Determining retention periods for volumes .................................
Retention Periods with end dates beyond 2038, excluding
Infinity ..........................................................................
Scalable Storage properties ..........................................................
Cloud Settings tab of the Scalable Storage properties ..................
Servers properties ......................................................................
Adding a server to a servers list ...............................................
Removing a server from a server list .........................................
Enabling NetBackup clustered master server inter-node
authentication ................................................................
Adding a trusted master server ................................................
Removing a trusted master server ............................................
Changing the master server that performs backups and restores
for a client .....................................................................
SharePoint properties ..................................................................
Consistency check options for SharePoint Server ........................
SLP Parameters properties ...........................................................
About batch creation logic in Storage Lifecycle Manager ...............
Deprecated storage lifecycle policy parameters ...........................
Symantec Products properties .......................................................
Throttle Bandwidth properties ........................................................
Add Bandwidth Settings dialog box for Throttle Bandwidth
properties .....................................................................
Timeouts properties ....................................................................

207
207
209
209
210
210
211
214
214
216
218
220
221
222
224
224
224
224
229
235
236
236
238
239
240
241
243
243
248
249
249
249
250
251

10

Contents

Universal Settings properties .........................................................

Logging the status of a redirected restore ..................................
UNIX Client properties .................................................................
UNIX Server properties ................................................................
VMware Access Hosts properties ...................................................
Windows Client properties ............................................................
Configuration options not found in the Host Properties ........................
About using commands to change the configuration options on UNIX
clients and servers ................................................................
Configuration options for NetBackup servers ....................................
ALLOW_MEDIA_OVERWRITE option for NetBackup
servers .........................................................................
ALLOW_NON_RESERVED_PORTS option for NetBackup servers
and clients .....................................................................
AUTHENTICATION_DOMAIN option for NetBackup servers and
clients ..........................................................................
AUTHORIZATION_SERVICE option for NetBackup servers ..........
AUTO_ADD_ALL_ALIASES_FOR_CLIENT option for NetBackup
servers .........................................................................
BPBRM_VERBOSE option for NetBackup servers .......................
BPDBJOBS_COLDEFS options for UNIX master servers ..............
BPDBM_VERBOSE option for NetBackup servers .......................
BPRD_VERBOSE option for NetBackup servers .........................
BPTM_VERBOSE option for NetBackup servers .........................
BPEND_TIMEOUT option for NetBackup servers ........................
BPSTART_TIMEOUT option for NetBackup servers .....................
CHECK_RESTORE_CLIENT option for NetBackup servers ..........
CLIENT_CONNECT_TIMEOUT option for NetBackup
servers .........................................................................
CLIENT_PORT_WINDOW option for NetBackup servers and
clients ..........................................................................
CLIENT_READ_TIMEOUT option for NetBackup servers ..............
CLIENT_RESERVED_PORT_WINDOW option for NetBackup
servers and clients ..........................................................
CONNECT_OPTIONS option for NetBackup servers and
clients ..........................................................................
DEFAULT_CONNECT_OPTIONS option for NetBackup servers
and clients .....................................................................
DISABLE_JOB_LOGGING option for NetBackup servers ..............
DISABLE_STANDALONE_DRIVE_EXTENSIONS option for
NetBackup servers ..........................................................
DISALLOW_BACKUPS_SPANNING_MEDIA option for NetBackup
servers .........................................................................

253
256
257
258
259
261
261
263
264
264
265
265
267
268
269
270
274
275
276
278
278
279
280
280
281
283
283
287
289
290
291

11

Contents

DISALLOW_CLIENT_LIST_RESTORE option for NetBackup

servers .........................................................................
DISALLOW_CLIENT_RESTORE option for NetBackup
servers .........................................................................
EMMSERVER option for NetBackup servers ..............................
ENABLE_ROBUST_LOGGING option for NetBackup
servers .........................................................................
FAILOVER_RESTORE_MEDIA_SERVERS option for NetBackup
servers .........................................................................
FORCE_RESTORE_MEDIA_SERVER option for NetBackup
servers .........................................................................
GENERATE_ENGLISH_LOGS option for NetBackup servers and
clients ..........................................................................
INCOMPLETE_JOB_CLEAN_INTERVAL option for NetBackup
servers and clients ..........................................................
INITIAL_BROWSE_SEARCH_LIMIT option for NetBackup servers
and clients .....................................................................
IP_ADDRESS_FAMILY option for NetBackup servers ..................
JOB_PRIORITY option for NetBackup servers and clients .............
LIMIT_BANDWIDTH option for NetBackup servers ......................
MEDIA_UNMOUNT_DELAY option for NetBackup servers ............
MEDIA_REQUEST_DELAY option for NetBackup servers ............
MEDIA_SERVER option for NetBackup servers ..........................
MPX_RESTORE_DELAY option for NetBackup servers ...............
MUST_USE_LOCAL_DRIVE option for NetBackup servers ...........
NBRNTD_IDLE_TIMEOUT option for NetBackup servers .............
PREFERRED_NETWORK option for NetBackup servers ..............
RANDOM _PORTS option for NetBackup servers and
clients ..........................................................................
RE_READ_INTERVAL option for NetBackup servers ...................
REQUIRED_NETWORK option for NetBackup servers .................
RESILIENT_NETWORK option for NetBackup master servers
and clients .....................................................................
RESUME_ORIG_DUP_ON_OPT_DUP_FAIL option for NetBackup
servers .........................................................................
REVERSE_NAME_LOOKUP option for NetBackup servers and
clients ..........................................................................
SERVER option for NetBackup servers .....................................
SERVER_CONNECT_TIMEOUT option for NetBackup
servers .........................................................................
SERVER_PORT_WINDOW option for NetBackup servers ............
SERVER_RESERVED_PORT_WINDOW option for NetBackup
servers and clients ..........................................................

291
292
293
293
294
295
296
297
298
299
299
301
302
302
303
304
304
305
306
309
310
310
311
313
313
314
317
317
318

12

Contents

SKIP_RESTORE_TO_SYMLINK_DIR option for NetBackup

servers .........................................................................
TELEMETRY_UPLOAD option for NetBackup servers .................
THROTTLE_BANDWIDTH option for NetBackup servers ..............
TRUSTED_MASTER option for NetBackup servers .....................
ULINK_ON_OVERWRITE option for NetBackup servers ...............
USE_VXSS option for NetBackup servers and clients ..................
VERBOSE option for NetBackup servers and clients ....................
VXSS_NETWORK option for NetBackup servers ........................
Configuration options for NetBackup clients .....................................
BPARCHIVE_POLICY option for NetBackup clients .....................
BPARCHIVE_SCHED option for NetBackup clients .....................
BPBACKUP_POLICY option for NetBackup clients ......................
BPBACKUP_SCHED option for NetBackup clients ......................
BUSY_FILE_ACTION option for NetBackup clients ......................
BUSY_FILE_DIRECTORY option for NetBackup clients ...............
BUSY_FILE_NOTIFY_USER option for NetBackup clients ............
BUSY_FILE_PROCESSING option for NetBackup clients .............
CLIENT_NAME option for NetBackup clients ..............................
COMPRESS_SUFFIX option for NetBackup clients .....................
CRYPT_CIPHER option for NetBackup clients ............................
CRYPT_KIND option for NetBackup clients ................................
CRYPT_OPTION option for NetBackup clients ...........................
CRYPT_STRENGTH option for NetBackup clients ......................
CRYPT_LIBPATH option for NetBackup clients ...........................
CRYPT_KEYFILE option for NetBackup clients ...........................
DISALLOW_SERVER_FILE_WRITES option for NetBackup
clients ..........................................................................
DO_NOT_RESET_FILE_ACCESS_TIME option for NetBackup
clients ..........................................................................
IGNORE_XATTR option for NetBackup clients ............................
INFORMIX_HOME option for NetBackup clients .........................
KEEP_DATABASE_COMM_FILE option for NetBackup
clients ..........................................................................
KEEP_LOGS_DAYS option for NetBackup clients .......................
LIST_FILES_TIMEOUT option for NetBackup clients ...................
LOCKED_FILE_ACTION option for NetBackup clients .................
MEDIA_SERVER option for NetBackup clients ...........................
MEGABYTES_OF_MEMORY option for NetBackup clients ...........
NFS_ACCESS_TIMEOUT option for NetBackup clients ................
OLD_VNETD_CALLBACK option for NetBackup clients ...............
REPORT_CLIENT_DISCOVERIES option for NetBackup
clients ..........................................................................

319
320
321
325
325
327
328
328
330
331
331
332
333
333
334
335
336
336
337
338
339
340
341
342
343
344
345
346
348
348
349
350
350
351
351
352
353
353

13

Contents

RESTORE_RETRIES option for NetBackup clients ......................

SERVER option for NetBackup clients ......................................
SYBASE_HOME option for NetBackup clients ............................
USE_CTIME_FOR_INCREMENTALS option for NetBackup
clients ..........................................................................
USE_FILE_CHG_LOG option for NetBackup clients ....................
USEMAIL option for NetBackup clients ......................................
VXSS_NETWORK option for NetBackup clients ..........................

Chapter 4

357
358
359
359

Configuring server groups ............................................... 361

About NetBackup server groups ....................................................
Configuring a NetBackup server group ............................................
NetBackup server group properties ..........................................
Deleting a server group ................................................................

Chapter 5

354
355
356

361
362
363
364

Configuring host credentials ........................................... 365

About configuring credentials ........................................................ 365

Chapter 6

Managing media servers .................................................. 366

Activating or deactivating a media server .........................................
Adding a media server .................................................................
About decommissioning a media server ..........................................
About decommissioning limitations ...........................................
Before you decommission a media server ..................................
Post decommission recommendations ......................................
Decommission actions ...........................................................
Previewing references to a media server .........................................
Decommissioning a media server ...................................................
Registering a media server ...........................................................
Deleting all devices from a media server ..........................................
Removing a device host from the EMM database ..............................

366
367
368
369
370
371
371
374
375
377
378
381

Section 3

Configuring storage .................................................. 382

Chapter 7

Configuring robots and tape drives ............................... 383

About NetBackup robot types ........................................................
About the device mapping files ......................................................
Downloading the device mapping files ............................................
About configuring robots and tape drives in NetBackup ......................
About device discovery ..........................................................

384
385
385
386
387

14

Contents

About device serialization .......................................................

About adding devices without discovery ....................................
About robot control ................................................................
About drive name rules ..........................................................
Configuring robots and tape drives by using the wizard .......................
Updating the device configuration by using the wizard ........................
Adding a robot to NetBackup manually ............................................
Robot configuration options ....................................................
Managing robots ........................................................................
Changing robot properties ......................................................
Configuring a robot to operate in manual mode ...........................
Deleting a robot ....................................................................
Moving a robot and its media to a new media server ....................
Adding a tape drive to NetBackup manually .....................................
Tape drive configuration options ...............................................
Configuring drive name rules .........................................................
Adding a tape drive path ..............................................................
About SCSI reserve on drive paths ...........................................
Drive path options .................................................................
About no rewind device files on UNIX .......................................
Adding a shared tape drive to a NetBackup environment ....................
Correlating tape drives and SCSI addresses on Windows hosts ...........
Windows device correlation example ........................................
Correlating tape drives and device files on UNIX hosts .......................
UNIX device correlation example .............................................
Managing tape drives ..................................................................
Changing a drive comment .....................................................
About downed drives .............................................................
Changing a drive operating mode ............................................
Changing a tape drive path .....................................................
Changing a drive path operating mode ......................................
Changing tape drive properties ................................................
Changing a tape drive to a shared drive ....................................
Cleaning a tape drive from the Device Monitor ............................
Deleting a drive ....................................................................
Resetting a drive ..................................................................
Resetting the mount time ........................................................
Setting the drive cleaning frequency .........................................
Viewing drive details ..............................................................
Performing device diagnostics .......................................................
Running a robot diagnostic test ................................................
Running a tape drive diagnostic test .........................................

388
388
389
390
391
392
392
394
397
397
398
398
399
400
402
406
407
407
408
409
409
409
410
411
412
413
413
414
414
415
415
416
416
417
418
418
419
419
420
420
420
422

15

Contents

Managing a diagnostic test step that requires operator

intervention ...................................................................
Obtaining detailed information for a diagnostic test step ................
Verifying the device configuration ...................................................
About automatic path correction .....................................................
Enabling automatic path correction .................................................
Replacing a device .....................................................................
Updating device firmware .............................................................
About the NetBackup Device Manager on Windows ...........................
About the Media Manager device daemon on UNIX ...........................
About external access to NetBackup controlled devices on
UNIX ............................................................................
Stopping and restarting the Device Manager or the device
daemon ..............................................................................

Chapter 8

Configuring tape media

423
423
424
424
425
425
427
428
428
429
429

.................................................. 431

About NetBackup tape volumes .....................................................

About NetBackup volume pools .....................................................
About reserved volume pool name prefixes ................................
About scratch volume pools ....................................................
About NetBackup volume groups ...................................................
NetBackup media types ...............................................................
About WORM media ...................................................................
About using volume pools to manage WORM media ....................
About using unique drive and media types to manage WORM
media ...........................................................................
Disabling WORM volume pool name verification .........................
About WORM media and the Quantum drive ..............................
Supported WORM drives ........................................................
About adding volumes .................................................................
About adding robotic volumes .................................................
About adding standalone volumes ............................................
Adding volumes by using the wizard ...............................................
About configuring media name and attribute rules .............................
About media settings rules ............................................................
Configuring media settings ...........................................................
Media settings options ...........................................................
About barcodes ..........................................................................
About barcode rules ..............................................................
Configuring barcode rules ............................................................
Barcode rules settings ...........................................................
About media ID generation rules ....................................................

432
432
433
434
435
435
437
438
440
440
441
441
441
442
442
443
443
444
444
445
452
453
455
456
458

16

Contents

Configuring media ID generation rules ............................................

Media ID generation options ...................................................
About media type mapping rules ....................................................
Configuring media type mappings ..................................................
About adding media type mapping entries .................................
Default and allowable media types ...........................................
Adding volumes by using the Actions menu ......................................
Volume properties .................................................................
Managing volumes ......................................................................
Changing the group of a volume ..............................................
About rules for moving volumes between groups .........................
Changing the owner of a volume ..............................................
Changing volume properties ...................................................
About assigning and deassigning volumes .................................
Deleting a volume .................................................................
Erasing a volume ..................................................................
About exchanging a volume ....................................................
About frozen media ...............................................................
About injecting and ejecting volumes ........................................
About rescanning and updating barcodes ..................................
About labeling NetBackup volumes ..........................................
About moving volumes ...........................................................
About recycling a volume .......................................................
Suspending or unsuspending volumes ......................................
Managing volume pools ...............................................................
Adding a volume pool ............................................................
Changing the properties of a volume pool ..................................
Deleting a volume pool ..........................................................
Managing volume groups on UNIX .................................................
Moving a volume group on UNIX ..............................................
Deleting a volume group ........................................................
About media sharing ...................................................................
Configuring unrestricted media sharing ...........................................
Configuring media sharing with a server group ..................................

Chapter 9

459
460
461
461
463
463
468
469
473
473
474
474
475
476
477
478
479
481
482
486
487
489
492
494
494
495
495
496
497
497
499
499
500
500

Inventorying robots ........................................................... 502

About robot inventory ..................................................................
When to inventory a robot .............................................................
About showing a robot's contents ...................................................
About inventory results for API robots .......................................
Showing the media in a robot ........................................................

502
503
505
506
508

17

Contents

About comparing a robot's contents with the volume

configuration ........................................................................
Comparing media in a robot with the volume configuration ..................
About updating the volume configuration .........................................
Volume update prerequisites ...................................................
About previewing volume configuration changes .........................
Updating the volume configuration with a robot's contents ...................
Robot inventory options ...............................................................
About the vmphyinv physical inventory utility ....................................
How vmphyinv performs a physical inventory ..............................
Example volume configuration updates ...........................................

Chapter 10

509
510
511
512
513
513
515
516
518
523

Configuring disk storage .................................................. 533

About configuring BasicDisk storage ............................................... 533
About configuring disk pool storage ................................................ 533
Inventorying a NetBackup disk pool ................................................ 534

Chapter 11

Configuring storage units ................................................ 535

About the Storage utility ...............................................................
Using the Storage utility .........................................................
Creating a storage unit .................................................................
Creating a storage unit by copying a storage unit ........................
Changing storage unit settings ................................................
Deleting storage units ............................................................
Media Manager storage unit considerations ...............................
Disk storage unit considerations ..............................................
NDMP storage unit considerations ...........................................
About storage unit settings ...........................................................
Absolute pathname to directory or absolute pathname to volume
setting for storage units ....................................................
Density storage unit setting .....................................................
Disk pool storage unit setting ..................................................
Disk type storage unit setting ..................................................
Enable block sharing storage unit setting ...................................
Enable multiplexing storage unit setting .....................................
High water mark storage unit setting .........................................
Low water mark storage unit setting ..........................................
Maximum concurrent write drives storage unit setting ...................
Maximum concurrent jobs storage unit setting ............................
Maximum streams per drive storage unit setting ..........................
Media server storage unit setting .............................................
NDMP host storage unit setting ...............................................

535
536
537
540
540
541
542
544
549
551
551
552
552
552
553
553
553
554
554
555
557
557
559

18

Contents

On demand only storage unit setting .........................................

Only use the following media servers storage unit setting ..............
Properties option in the Change Storage Units dialog box .............
Reduce fragment size storage unit setting ..................................
Robot number storage unit setting ............................................
Robot type storage unit setting ................................................
Staging schedule option in Change Storage Units dialog ...............
Storage device setting for storage units .....................................
Storage unit name setting .......................................................
Storage unit type setting .........................................................
Enable temporary staging area storage unit setting ......................
Use any available media server storage unit setting .....................

Chapter 12

Staging backups ................................................................ 566

About staging backups ................................................................
About basic disk staging ...............................................................
Creating a basic disk staging storage unit ........................................
Creating a schedule for a basic disk staging storage unit ..............
Configuring multiple copies in a relocation schedule ...........................
Disk staging storage unit size and capacity ......................................
Finding potential free space on a BasicDisk disk staging storage
unit ....................................................................................
Disk Staging Schedule dialog box ..................................................
Initiating a relocation schedule manually ..........................................

Chapter 13

559
560
560
562
563
563
563
563
564
564
564
564

566
567
568
569
570
572
574
575
578

Configuring storage unit groups .................................... 579

About storage unit groups .............................................................
Creating storage unit groups for backups .........................................
Creating storage unit groups for snapshots ......................................
Deleting a storage unit group ........................................................
Storage unit selection criteria within a group .....................................
Media server load balancing ...................................................
Other load balancing methods .................................................
Exception to the storage unit selection criteria ............................
About disk spanning within storage unit groups .................................

579
580
582
584
584
586
586
588
588

19

Contents

Section 4

Configuring storage lifecycle policies

(SLPs) .......................................................................... 589

Chapter 14

Configuring storage lifecycle policies ........................... 590

About storage lifecycle policies ......................................................
Creating a storage lifecycle policy ..................................................
Modifying the hierarchy of operations in a storage lifecycle
policy ...........................................................................
Deleting a storage lifecycle policy ...................................................
Lifecycle operation administration using the nbstlutil command ............

Chapter 15

594
595
596

Storage operations ............................................................ 598

Operation types in a storage lifecycle policy .....................................
Backup operation in an SLP ..........................................................
Backup From Snapshot operation in an SLP ....................................
Duplication operation in an SLP .....................................................
Import operation in an SLP ...........................................................
Index From Snapshot operation in an SLP .......................................
Determining where and when the Index From Snapshot operation
occurs ..........................................................................
Replication operation in an SLP .....................................................
Snapshot operation in an SLP .......................................................
About configuring storage lifecycle policies for snapshots and
snapshot replication ........................................................
Primary snapshot storage unit .................................................
Primary + Replication source snapshot storage unit .....................
Replication source + Replication target snapshot storage
unit ..............................................................................
Replication target snapshot storage unit ....................................
Replication source + Replication target + Mirror snapshot storage
unit ..............................................................................
Replication target + Mirror snapshot storage unit .........................
Creating a hierarchy of storage operations in a storage lifecycle
policy .................................................................................

Chapter 16

590
591

598
598
600
602
604
606
608
609
611
613
615
616
617
617
618
618
618

Retention types for SLP operations ............................... 620

Retention types for storage lifecycle policy operations ........................ 620
Capacity managed retention type for SLP operations ......................... 622
Rules and recommendations for using the Capacity Managed
retention type ................................................................. 623

20

Contents

Capacity managed retention type and disk types that support

SIS ..............................................................................
Expire after copy retention type for SLP operations ............................
Fixed retention type for SLP operations ...........................................
Maximum snapshot limit retention type for SLP operations ..................
Mirror retention type for SLP operations ..........................................
Target retention type for SLP operations ..........................................

Chapter 17

Storage lifecycle policy options ...................................... 628

Storage Lifecycle Policy dialog box settings .....................................
New or Change Storage Operation dialog box settings .......................
Properties tab of the Storage Operation dialog box ......................
Window tab of the Storage Operation dialog box .........................
Creating a new window for a storage lifecycle policy
operation ......................................................................
Excluding days from a window for a storage lifecycle policy
operation ......................................................................
Storage lifecycle policy validation dialog box ....................................
Storage lifecycle policy Validation Report tab ....................................

Chapter 18

623
623
624
625
626
627

628
632
632
636
638
639
640
641

Using a storage lifecycle policy to create multiple

copies ............................................................................. 643
About writing multiple copies using a storage lifecycle policy ................ 643
How the order of the operations determines the copy order ................. 644
About ensuring successful copies using lifecycles ............................. 644

Chapter 19

Storage lifecycle policy versions .................................... 646

About storage lifecycle policy versions ............................................
Storage lifecycle changes and versioning ........................................
When changes to storage lifecycle policies become effective ...............
Deleting old storage lifecycle policy versions ....................................

646
647
649
649

Section 5

Configuring backups ................................................ 651

Chapter 20

Creating backup policies ................................................. 652

About the Policies utility ...............................................................
Planning for policies ....................................................................
Windows example of one client in multiple policies ......................
Policy attributes that affect how clients are grouped in
policies .........................................................................

653
656
659
660

21

Contents

About Microsoft DSFR backups ...............................................

Creating a backup policy ..............................................................
Adding or changing schedules in a policy ........................................
Changing multiple policies at one time on Windows ...........................
Copying or moving policy items to another policy or server on
Windows .............................................................................
Copying a policy to create a new policy on UNIX ...............................
Copying a schedule into the same policy or different policy on
UNIX ..................................................................................
Deleting schedules, backup selections, or clients from a policy .............
Policy Attributes tab ....................................................................
Policy type (policy attribute) ....................................................
Data classifications (policy attribute) .........................................
Policy storage (policy attribute) ................................................
Policy volume pool (policy attribute) ..........................................
Take checkpoints every __ minutes (policy attribute) ....................
Limit jobs per policy (policy attribute) ........................................
Job priority (policy attribute) ....................................................
Media Owner (policy attribute) .................................................
Go into effect at (policy attribute) ..............................................
Follow NFS (policy attribute) ...................................................
Backup Network Drives (policy attribute) ....................................
Cross mount points (policy attribute) .........................................
Compression (policy attribute) .................................................
Encryption (policy attribute) .....................................................
Collect disaster recovery information for Bare Metal Restore (policy
attribute) .......................................................................
Collect true image restore information (policy attribute) with and
without move detection ....................................................
Allow multiple data streams (policy attribute) ..............................
Disable client-side deduplication (policy attribute) ........................
Enable granular recovery (policy attribute) .................................
Use Accelerator (policy attribute) .............................................
Keyword phrase (policy attribute) .............................................
Enable indexing for search (policy attribute) ...............................
Indexing server (policy attribute) ..............................................
Enable optimized backup of Windows deduplicated volumes .........
Snapshot Client and Replication Director (policy attributes) ...........
Perform block level incremental backups (policy attributes) ...........
Use Replication Director (policy attributes) .................................
Perform snapshot backups (policy attributes) ..............................
Microsoft Exchange Attributes (policy attributes) .........................
Schedules tab ............................................................................

661
664
666
666
668
669
669
670
670
671
675
675
678
680
684
685
686
686
687
688
690
694
696
698
698
702
706
706
707
723
723
724
724
727
728
728
730
730
730

22

Contents

Schedule Attributes tab ................................................................

Name (schedule attribute) ......................................................
Type of backup (schedule attribute) ..........................................
Synthetic backup (schedule attribute) ........................................
Accelerator forced rescan option (schedule attribute) ...................
Enable indexing for search (schedule attribute) ...........................
Calendar (schedule attribute) ..................................................
Frequency (schedule attribute) ................................................
Instant Recovery (schedule attribute) ........................................
Multiple copies (schedule attribute) ...........................................
Override policy storage (schedule attribute) ................................
Override policy volume pool (schedule attribute) .........................
Override media owner (schedule attribute) .................................
Retention (schedule attribute) ..................................................
Media multiplexing (schedule attribute) ......................................
Start Window tab ........................................................................
Adding, changing, or deleting a time window in a policy
schedule .......................................................................
Example of schedule duration .................................................
Excluding days from a schedule .....................................................
Include Days tab .........................................................................
Calendar scheduling with the Include Days tab ...........................
How NetBackup determines which schedule to run next .....................
About schedule windows that span midnight .....................................
How open schedules affect calendar-based and frequency-based
schedules ...........................................................................
Creating an open schedule in the NetBackup Administration
Console ........................................................................
Runtime considerations that affect backup frequency ...................
About the Clients tab ...................................................................
Adding or changing clients in a policy ........................................
Installing client software on secure and trusting UNIX clients .........
Browse for Hyper-V virtual machines ........................................
Backup Selections tab .................................................................
Adding backup selections to a policy .........................................
Verifying the Backup Selections list ..........................................
How to reduce backup time .....................................................
Pathname rules for Windows client backups ...............................
Pathname rules for Windows disk image (raw) backups ................
Pathname rules for Windows registry backups ............................
About hard links to files and directories .....................................
Pathname rules for UNIX client backups ....................................
Pathname rules for the clients that run extension products ............

731
732
732
741
742
743
744
744
746
747
751
752
752
753
756
763
763
768
769
770
770
771
774
775
777
778
778
779
784
785
786
787
791
794
795
797
799
800
802
810

23

Contents

About the directives on the Backup Selections list .......................

Files that are excluded from backups by default ..........................
About excluding files from automatic backups .............................
Files that are excluded by Microsoft Windows Backup ..................
VMware Policy tab ......................................................................
Hyper-V Policies tab ....................................................................
Disaster Recovery tab .................................................................
Adding policies to the Critical Policies list of a catalog backup
policy ...........................................................................
Creating a Vault policy .................................................................
Performing manual backups .........................................................
Active Directory granular backups and recovery ................................
System requirements for Active Directory granular NetBackup
backups and recovery .....................................................
Creating a policy that allows Active Directory granular
restores ........................................................................
Restoring Active Directory objects ............................................
Troubleshooting granular restore issues ....................................

Chapter 21

832
832
834
835
836
836
838
840

Synthetic backups ............................................................. 843

About synthetic backups ..............................................................
Recommendations for synthetic backups and restores .......................
Synthetic full backups ..................................................................
Synthetic cumulative incremental backups .......................................
Schedules that must appear in a policy for synthetic backups ..............
Adding clients to a policy for synthetic backups .................................
Change journal and synthesized backups ........................................
True image restore and synthesized backups ...................................
Displaying synthetic backups in the Activity Monitor ...........................
Logs produced during synthetic backups .........................................
Synthetic backups and directory and file attributes .............................
Using the multiple copy synthetic backups method ............................
Configuring multiple copy synthetic backups ...............................
Configuration variables for multiple copy synthetic backups ...........
Multiple copy synthetic backups configuration examples ...............
Optimized synthetic backups .........................................................
Optimized synthetic backups for deduplication ..................................

Chapter 22

810
823
824
825
825
827
828

843
844
847
848
850
850
851
851
851
852
852
853
854
855
856
857
857

Protecting the NetBackup catalog ................................. 858

About the NetBackup catalog ........................................................ 858
Parts of the NetBackup catalog ...................................................... 859
About the NetBackup image database ...................................... 861

24

Contents

About the NetBackup relational database ..................................

Protecting the NetBackup catalog ..................................................
About catalog backups ..........................................................
Recovering the catalog ................................................................
Disaster recovery emails and the disaster recovery file .......................
Archiving the catalog and restoring from the catalog archive ................
Creating a catalog archiving policy ...........................................
Catalog archiving commands ..................................................
Catalog archiving considerations .............................................
Extracting images from the catalog archives ...............................
Estimating catalog space requirements ...........................................
NetBackup file size considerations on UNIX systems ...................
About the binary catalog format ...............................................
Moving the image catalog .......................................................
About image catalog compression ............................................

Chapter 23

863
867
868
879
879
880
882
883
885
886
886
888
888
888
891

About the NetBackup relational database ................... 895

About the NetBackup relational database (NBDB) installation ..............
About NetBackup master server installed directories and
files ..............................................................................
About the NetBackup configuration entry ...................................
Sybase SQL Anywhere server management ..............................
Sybase SQL Anywhere and clustered environments ....................
Using the NetBackup Database Administration utility on Windows ........
About the General tab of the NetBackup Database Administration
utility ............................................................................
About the Tools tab of the NetBackup Database Administration
utility ............................................................................
Using the NetBackup Database Administration utility on UNIX .............
About the Select/Restart Database and Change Password menu
options .........................................................................
About the Database Space and Memory Management menu
options .........................................................................
About the Database Validation Check and Rebuild menu
options .........................................................................
About the Move Database menu options ...................................
About the Unload Database menu options .................................
About the Backup and Restore Database menu options ................
Post-installation tasks ..................................................................
Changing the NetBackup database password .............................
Moving NBDB database files after installation .............................
Adding a mirrored transaction log .............................................

895
898
907
907
909
909
910
917
923
925
926
928
929
930
931
932
932
933
935

25

Contents

Creating the NBDB database manually .....................................

About backup and recovery procedures ..........................................
Database transaction log ........................................................
About catalog recovery ..........................................................
Commands for backing up and recovering the relational
databases .....................................................................
About the catalog backup process ............................................
Unloading the NetBackup database ................................................
Terminating database connections .................................................
Moving the NetBackup database from one host to another ..................

Chapter 24

936
939
939
940
940
942
943
944
946

Managing backup images ................................................ 947

About the Catalog utility ...............................................................
About searching for backup images ................................................
Verifying backup images ..............................................................
Viewing job results ......................................................................
Promoting a copy to a primary copy ................................................
Duplicating backup images ...........................................................
About multiplexed duplication considerations ..............................
Jobs that appear while making multiple copies ............................
Expiring backup images ...............................................................
About importing backup images .....................................................
Importing backup images, Phase I ............................................
Importing backup images, Phase II ...........................................
About importing expired images ...............................................
Initiating an import without the Import Wizard on Windows ............
About importing Backup Exec media .........................................
Differences between importing, browsing, and restoring Backup
Exec and NetBackup images ............................................

947
949
951
952
952
955
960
961
962
963
963
965
966
967
968
971

Section 6

Configuring replication .......................................... 974

Chapter 25

About NetBackup replication .......................................... 975

About NetBackup replication .........................................................
About NetBackup Auto Image Replication ........................................
One-to-many Auto Image Replication model ...............................
Cascading Auto Image Replication model ..................................
About the domain relationship for replication ..............................
About the replication topology for Auto Image Replication .............
Viewing the replication topology for Auto Image Replication ...........
About trusted master servers for Auto Image Replication ..............

975
976
978
978
980
981
982
988

26

Contents

About the storage lifecycle policies required for Auto Image

Replication .................................................................... 988
Using NetBackup Access Control (NBAC) with Auto Image
Replication .................................................................... 993
Auto Image Replication setup overview ..................................... 994
Configuring MSDP replication to a different NetBackup
domain ......................................................................... 995
Configuring replication to an OpenStorage device in a different
domain ....................................................................... 1005
How to resolve volume changes for Auto Image Replication ......... 1006
About restoring from a backup at a target master domain ............ 1009
Reporting on Auto Image Replication jobs ................................ 1010
About NetBackup Replication Director ........................................... 1011

Section 7

Monitoring and reporting .................................... 1013

Chapter 26

Monitoring NetBackup activity ..................................... 1014

About the Activity Monitor ...........................................................
Setting Activity Monitor options ....................................................
Topology view in the Activity Monitor .............................................
About the Jobs tab ....................................................................
Viewing job details in the Activity Monitor .................................
Showing or hiding column heads in the Activity Monitor ...............
Monitoring the detailed status of a selected job in the Activity
Monitor .......................................................................
Deleting completed jobs in the Activity Monitor ..........................
Canceling a job that has not completed in the Activity
Monitor .......................................................................
Restarting a failed (completed) job in the Activity Monitor ............
Suspending restore or backup jobs in the Activity Monitor ............
Resuming suspended or incomplete jobs in the Activity
Monitor .......................................................................
Printing job list information in the Activity Monitor .......................
Exporting Activity Monitor data to a text file on UNIX ..................
Printing job detail information on Windows ...............................
Copying Activity Monitor text to a file on Windows ......................
Changing the Job Priority dynamically from the Activity
Monitor .......................................................................
About the Services or Daemons tab ..............................................
Using the nbrbutil utility to configure the NetBackup Resource
Broker ........................................................................
Types of NetBackup daemons ...............................................

1014
1016
1018
1019
1021
1021
1022
1022
1022
1023
1023
1023
1024
1024
1024
1025
1025
1026
1031
1036

27

Contents

Monitoring NetBackup services or daemons .............................

Starting or stopping a service or daemon .................................
Displaying all media servers in the Activity Monitor .....................
About the Processes tab .............................................................
Monitoring NetBackup processes in the Process Details dialog
box ............................................................................
About the Drives tab on Windows .................................................
Monitoring tape drives on Windows .........................................
Cleaning tape drives from the Activity Monitor on Windows ..........
About the jobs database .............................................................
Changing the default bpdbjobs_options values ..........................
About the BPDBJOBS_OPTIONS environment variable ..............
bpdbjobs command line options .............................................
Enabling the bpdbjobs debug log ...........................................
About the Device Monitor ............................................................
About media mount errors ...........................................................
About pending requests and actions .............................................
About pending requests for storage units .................................
Resolving a pending request .................................................
Resolving a pending action ...................................................
Resubmitting a request ........................................................
Denying a request ...............................................................

Chapter 27

1042
1044
1045
1046
1046
1047
1048
1050
1050
1050
1050
1051
1052
1053
1054
1054
1055

Auditing NetBackup operations .................................... 1056

About NetBackup auditing ...........................................................
Viewing the current audit settings .................................................
Configuring auditing on a NetBackup master server .........................
Audit alert notification for audit failures ..........................................
User identity in the audit report ....................................................
Auditing host property changes ....................................................
Using the command line -reason or -r option ...................................
Viewing the audit report ..............................................................
nbaudit log behavior ..................................................................
Retaining and backing up audit trail records ....................................

Chapter 28

1036
1036
1037
1037

1056
1059
1060
1061
1062
1063
1063
1064
1068
1069

Reporting in NetBackup ................................................. 1070

About the Reports utility .............................................................
Running a report .......................................................................
Copying report text to another document ........................................
Saving or exporting a report ........................................................
Printing a report ........................................................................

1070
1074
1074
1075
1075

28

Contents

Chapter 29

Using the Logging Assistant .......................................... 1077

About the Logging Assistant ........................................................
Logging Assistant sequence of operation .......................................
Viewing the Logging Assistant records ..........................................
Viewing the details of a Logging Assistant record .............................
Adding a new Logging Assistant record .........................................
Deleting a Logging Assistant record ..............................................
Setting up debug logging ............................................................
Set minimum debug logging ........................................................
Disabling debug logging .............................................................
Collecting and uploading debug logs .............................................
Collecting and uploading nbsu information .....................................
Uploading evidence ...................................................................

1077
1079
1081
1081
1084
1086
1087
1091
1092
1093
1099
1102

Section 8

Administering NetBackup ................................... 1105

Chapter 30

Management topics ......................................................... 1106

Configuring the NetBackup Client Service ......................................
NetBackup naming conventions ...................................................
Wildcard use in NetBackup .........................................................
Wildcard characters in backup selections for an NDMP policy ............
How to administer devices on other servers ....................................
How to access media and devices on other hosts ............................

Chapter 31

Accessing a remote server ............................................. 1115

Accessing remote servers ...........................................................
About adding a NetBackup server to a server list .............................
Adding a server to a remote server list .....................................
About choosing a remote server to administer .................................
Using the change server command to administer a remote
server .........................................................................
Indicating a remote system upon login .....................................
About running the NetBackup Administration Console on a NetBackup
client ................................................................................
About troubleshooting remote server administration .........................

Chapter 32

1106
1107
1108
1110
1113
1114

1115
1116
1117
1119
1120
1121
1123
1124

Using the NetBackup-Java administration

console ......................................................................... 1125
About the Java-based NetBackup Administration Console ................. 1126
About authorizing NetBackup-Java users ....................................... 1128

29

Contents

Authorization file (auth.conf) characteristics ....................................

About authorizing nonroot users for specific applications ...................
About authorizing specific tasks in jbpSA .......................................
About authorizing users on the Java Windows Administration
Console ............................................................................
Restricting access to NetBackup-Java applications on Windows .........
Runtime configuration options for Java Windows and NetBackup-Java
Administration Console ........................................................
FIREWALL_IN ....................................................................
FORCE_IPADDR_LOOKUP ..................................................
INITIAL_MEMORY, MAX_MEMORY .......................................
MEM_USE_WARNING ........................................................
NBJAVA_CLIENT_PORT_WINDOW .......................................
NBJAVA_CORBA_DEFAULT_TIMEOUT ..................................
NBJAVA_CORBA_LONG_TIMEOUT ......................................
PBX_PORT .......................................................................
VNETD_PORT ...................................................................
About logging the command lines that the NetBackup interfaces
use ..................................................................................
About customizing jnbSA and jbpSA with bp.conf entries ...................
About improving NetBackup-Java performance ...............................
About running the Java console locally ....................................
About running a console locally and administering a remote
server .........................................................................
About enhancing console performance ....................................
About determining better performance when console is run locally
or uses remote display back ............................................
About adjusting time zones in the NetBackup-Java console ...............
Adjusting the time zone in the NetBackup-Java console ..............
Configuring a custom time zone in the NetBackup-Java
console .......................................................................

Chapter 33

1129
1131
1132
1133
1134
1134
1135
1136
1137
1138
1138
1139
1139
1140
1140
1140
1141
1141
1142
1142
1143
1144
1145
1146
1146

Alternate server restores ................................................ 1148

About alternate server restores ....................................................
About supported configurations for alternate server restores ..............
About performing alternate server restores .....................................
About modifying the NetBackup catalogs .................................
Overriding the original server for restores .................................
About enabling automatic failover to an alternate server ..............
Expiring and importing media for alternate server restores ...........

1148
1149
1150
1151
1152
1154
1155

30

Contents

Chapter 34

Managing client backups and restores ....................... 1157

About server-directed restores .....................................................
About client-redirected restores ....................................................
About restore restrictions ......................................................
Allowing all clients to perform redirected restores .......................
Allowing a single client to perform redirected restores .................
Allowing redirected restores of a specific clients files .................
Examples of redirected restores .............................................
About restoring the files that have Access Control Lists (ACLs) ..........
About setting the original atime for files during restores on UNIX .........
Restoring the System State .........................................................
About the backup and restore of compressed files on VxFS file
systems ............................................................................
About backups and restores on ReFS ...........................................

Chapter 35

1170
1171

Powering down and rebooting NetBackup

servers .......................................................................... 1172
Powering down and rebooting NetBackup servers ...........................
Shutting down and starting up all NetBackup services and
daemons ...........................................................................
Rebooting a NetBackup server ....................................................
Rebooting a NetBackup media server ...........................................
About displaying active processes with bpps on UNIX ......................
About displaying robotic processes with vmps on UNIX .....................

Chapter 36

1157
1158
1159
1159
1160
1160
1161
1166
1168
1168

1172
1173
1174
1174
1175
1176

About Granular Recovery Technology ......................... 1177

About installing and configuring Network File System (NFS) for Active
Directory Granular Recovery .................................................
About configuring Services for Network File System (NFS) on Windows
2012 ................................................................................
Enabling Services for Network File System (NFS) on a Windows
2012 media server ........................................................
Enabling Services for Network File System (NFS) on a Windows
2012 client ...................................................................
About configuring Services for Network File System (NFS) on Windows
2008 and Windows 2008 R2 .................................................
Enabling Services for Network File System (NFS) on Windows
2008 or Windows 2008 R2 ..............................................
Disabling the Client for NFS on the media server .......................
Disabling the Server for NFS .................................................

1177
1178
1179
1183
1185
1187
1189
1191

31

Contents

About configuring Services for Network File System (NFS) on Windows

2003 R2 SP2 .....................................................................
Installing Services for NFS on the Windows 2003 R2 SP2 media
server .........................................................................
Installing Services for NFS on Active Directory domain controllers
or ADAM/LDS hosts with Windows 2003 R2 SP2 .................
Configuring a UNIX media server and Windows clients for backups
and restores that use Granular Recovery Technology (GRT) ........
Configuring a different network port for NBFSD ...............................

1193
1195
1198
1201
1201

Index ................................................................................................................. 1203

32

Section

About NetBackup

Chapter 1. Introducing NetBackup interfaces

Chapter 2. Administering NetBackup licenses

Chapter

Introducing NetBackup
interfaces
This chapter includes the following topics:

About NetBackup

NetBackup documentation

About NetBackup administration interfaces

Using the NetBackup Administration Console

NetBackup configuration wizards

Running the Troubleshooter

About NetBackup
NetBackup provides a complete, flexible data protection solution for a variety of
platforms. The platforms include Windows, UNIX, and Linux systems.
NetBackup administrators can set up periodic or calendar-based schedules to
perform automatic, unattended backups for clients across a network. An
administrator can carefully schedule backups to achieve systematic and complete
backups over a period of time, and optimize network traffic during off-peak hours.
The backups can be full or incremental. Full backups back up all client files.
Incremental backups back up only the files that have changed since the last backup.
The NetBackup administrator can allow users to back up, restore, or archive the
files from their computer. (An archive operation backs up a file, then deletes it from
the local disk if the backup is successful.)
NetBackup includes both the server and the client software as follows:

Introducing NetBackup interfaces

About NetBackup

Server software resides on the computer that manages the storage devices.

Client software resides on computer(s) that contain data to back up. (Servers
also contain client software and can be backed up.)

Figure 1-1 shows an example of a NetBackup storage domain.

NetBackup storage domain example

Figure 1-1

NetBackup
master server

Media servers

SAN

Media Manager tape BasicDisk

storage unit
storage unit

OpenStorage
disk pool

NetBackup
clients

NetBackup accommodates multiple servers that work together under the

administrative control of one NetBackup master server in the following ways:

The master server manages backups, archives, and restores. The master server
is responsible for media and device selection for NetBackup. Typically, the
master server contains the NetBackup catalog. The catalog contains the internal
databases that contain information about NetBackup backups and configuration.

Media servers provide additional storage by allowing NetBackup to use the

storage devices that are attached to them. Media servers can also increase
performance by distributing the network load. Media servers can also be referred
to by using the following terms:

Device hosts (when tape devices are present)

Storage servers (when I/O is directly to disk)

35

Introducing NetBackup interfaces

NetBackup documentation

Data movers (when data is sent to independent, external disk devices like
OpenStorage appliances)

During a backup or archive, the client sends backup data across the network to a
NetBackup server. The NetBackup server manages the type of storage that is
specified in the backup policy.
During a restore, users can browse, then select the files and directories to recover.
NetBackup finds the selected files and directories and restores them to the disk on
the client.

NetBackup documentation
For a complete list of NetBackup technical documents for each supported release,
see the NetBackup Release Notes, Administration, Installation, Troubleshooting,
Getting Started, and Solutions Guides page at the following URL:
http://www.symantec.com/docs/DOC5332
The documents are in Adobe Portable Document Format (PDF), viewable with
the Adobe Acrobat Reader. Download the reader from http://www.adobe.com.
Symantec assumes no responsibility for the installation and use of the reader.
The NetBackup landing page on the Symantec Support website contains a list of
helpful how-to and product alert topics.

About NetBackup administration interfaces

The NetBackup administrator has a choice of several interfaces to use to administer
NetBackup. All the interfaces have similar capabilities. The best choice depends
on personal preference and the workstation that is available to the administrator.

36

Introducing NetBackup interfaces

About NetBackup administration interfaces

Table 1-1

NetBackup administration interfaces

Name of
interface

Description

NetBackup
Administration
Console

The NetBackup Administration Console is the recommended interface and is the interface
referred to by most procedures and examples in the documentation.

On computers running Windows:

The NetBackup Administration Console is installed with the NetBackup server software.
This console is the starting point for administering NetBackup.
To start the console on the Windows platform, select NetBackup Administration Console
from the Start menu.
On computers running UNIX:
Start the Java-based, graphical user interface by running the jnbSA command.
You can run the console on a Java-capable UNIX computer and display it back to a Windows
computer by using third-party X terminal emulation software.
See About setting up the NetBackup Administration Console on UNIX on page 39.

Note: To log in to any NetBackup Administration Console, your login credentials must be
authenticated from the connecting master or media server. This is true whether or not NetBackup
Access Control (NBAC) is in use.
Remote
Administration
Console

Install the Remote Administration Console on a Windows computer to remotely manage a

NetBackup server of any supported platform.
Installing this console installs the NetBackup Administration Console and the client software.
The presence of the client software enables the computer to be backed up like any other client.
No master server software or media server software is installed.
No license is required to install the Remote Administration Console. The installation screen
(Figure 1-2) is presented as part of the Server Software Installation.

37

Introducing NetBackup interfaces

About NetBackup administration interfaces

Table 1-1
Name of
interface

NetBackup administration interfaces (continued)

Description

Character-based, The menu interface is used on UNIX platforms.

menu interfaces
NetBackup management
Start a character-based, menu interface for NetBackup management by running the bpadm
command. You can use the bpadm interface from any terminal (or terminal emulation window)
that has a termcap or a terminfo definition.

Media management
Start a character-based, menu interface for media management by running the vmadm command.
You can use the vmadm interface from any terminal (or terminal emulation window) that has a
termcap or a terminfo definition.

Device management
Start a character-based, menu interface for device management by running the tpconfig
command. You can use the tpconfig interface from any terminal (or terminal emulation
window) that has a termcap or a terminfo definition.

For more information about the menu interfaces, see the NetBackup Administrator's Guide, Volume
II.
Command line

NetBackup commands are available on both Windows and UNIX platforms. Enter NetBackup
commands at the system prompt or use the commands in scripts.
All NetBackup administrator programs and commands require root or administrator user privileges
by default.
See About authorizing nonroot users for specific applications on page 1131.
For complete information on all NetBackup commands, see the NetBackup Commands Reference
Guide.
To view the commands online, use the UNIX man command.

Note: If there is more than one NetBackup server, the NetBackup Administration
Console can be run on more than one server at one time. However, if more than
one administrator makes changes to the configuration, the results are unpredictable.

38

Introducing NetBackup interfaces

About NetBackup administration interfaces

Figure 1-2

NetBackup Remote Administration Console installation panel

See Using the NetBackup Administration Console on page 45.

See Administering remote servers of different versions on page 43.

About setting up the NetBackup Administration Console on UNIX

NetBackup provides two Java-based administration consoles through which the
administrator can manage NetBackup. The consoles can be run on either of the
following systems:

Directly on a supported NetBackup-Java capable UNIX computer by running

/usr/openv/java/jnbSA &

The jnbSA command is described in the NetBackup Commands Reference

Guide.

On a supported computer running Windows that has the NetBackup Java

Windows Administration Console installed. The NetBackup Java Windows
Administration Console is not automatically installed. Installation is available on
the main NetBackup for Windows installation screen.

39

Introducing NetBackup interfaces

About NetBackup administration interfaces

Startup procedures and configuration information is explained in the following topics.

Setting up a CDE for the Java-based NetBackup interfaces on

UNIX
Always set the window manager so that a window becomes active only when clicked.
The NetBackup Java interfaces do not run properly with auto-focus enabled.
Auto-focus causes a window to become active when the pointer moves over the
window.
The following are general instructions for correctly setting up the focus on a CDE
(Common Desktop Environment) window manager. CDE is the preferred window
manager for NetBackup Java applications.
The NetBackup host that is specified on the login dialog box and the computer
where you start the NetBackup Java Windows Administration Console must run
the same NetBackup version.
The NetBackup Administration Console supports remote X Windows display
only between same-platform systems. For example, assume that you are on a
Solaris system named system1 and the NetBackup-Java software is on a Solaris
system named system2. Here, you can display the interface on system1 by
performing rlogin to system2. Then run jnbSA -d system1. However, if system2
was an HP system, you could display jnbSA only directly on system2.
In addition, the system where the console appears must run a version of the
operating system that the console supports. Refer to the NetBackup release notes
for supported versions, including any required release updates.
The jnbSA command is described in the NetBackup Commands Reference Guide.
To set up a CDE (Common Desktop Environment) for NetBackup Java interfaces

On the front panel in the CDE window, click the Style Manager control icon.

On the Style Manager toolbar, click the Window control icon.

In the Style Manager-Window dialog box, click the Click In Window To Make
Active button.

Click OK.

Click OK when prompted to Restart the Workspace Manager.

Starting the NetBackup Administration Console on UNIX

Use the following procedure to start the NetBackup Administration Console on
a Java-capable UNIX computer.

40

Introducing NetBackup interfaces

About NetBackup administration interfaces

All operations are performed through the NetBackup Java application server that
runs on all NetBackup-supported systems. Log into the NetBackup Java application
server that runs on the NetBackup server that you want to administer.
To start the NetBackup Administration Console on a Java-capable computer running
UNIX

Log in as root on the NetBackup client or server where you want to start the
NetBackup Administration Console. The client or server must be
NetBackup-Java capable.

Start the console by entering the following command:

/usr/openv/java/jnbSA &

In the login screen, type or select the name of the UNIX master server host
where you initially want to manage NetBackup.

Specify your user name and password, then click Login.

You are logged into the NetBackup-Java application server program on the
specified server. The console program continues to communicate through the
server you specified for the remainder of the current session.

Start a utility by clicking on it in the left pane.

To administer a different NetBackup server, select File > Change Server to

select a remote NetBackup server on which to make configuration changes.
To log in, your login credentials must be authenticated from the connecting
master or media server. This is true whether or not NetBackup Access Control
(NBAC) is in use.

See About NetBackup administration interfaces on page 36.

See Administering remote servers of different versions on page 43.

About using the Java Windows Administration Console

Use the NetBackup Java Windows Administration Console to administer UNIX
NetBackup computers that are not Java-capable. The Java Windows Administration
Console is sometimes referred to as the Windows Display Console.
No license is required to install the Java Windows Administration Console. Installing
this console installs the NetBackup Administration Console only. No NetBackup
master server, media server, or client software is installed.

41

Introducing NetBackup interfaces

About NetBackup administration interfaces

Note: To use the NetBackup Java Windows Administration Console, the Microsoft
Windows UAC (User Access Control) feature must be disabled. See the following
link for instructions:
http://windows.microsoft.com/en-us/windows/turn-user-account-control-on-off#1TC=windows-7
Figure 1-3 shows the Java Windows Administration Console on the installation
wizard panel.
Figure 1-3

Java Windows Administration Console selection on the installation

panel

The following procedure describes how to start the Java Windows Administration
Console.
To start the Java Windows Administration Console

On a Windows system where the Java Windows Administration Console is

installed and configured, select Start > Programs > Symantec NetBackup
> NetBackup-Java Version 7.6.1.

The login screen for the NetBackup Administration Console displays the
host name. Log into another server by typing the name of another host in the
Host name field. Or, select a host name from the drop-down list.

42

Introducing NetBackup interfaces

About NetBackup administration interfaces

In the login screen, type your user name and password. To log into a Windows
server, enter both the domain of the server and the user name as follows:
domain_name\user_name

The domain_name specifies the domain of the NetBackup host. If the host is
not a member of a domain, the domain_name is not required.

Click Login to log into the NetBackup-Java application server program on the
specified server. The interface program continues to communicate through the
server that is specified in the login screen for the remainder of the current
session.
The default host is the last host that was successfully logged into. The
drop-down list contains the names of other hosts that have been logged into.

See Accessing remote servers on page 1115.

Administering remote servers of different versions

In a site that contains multiple master servers of different versions, you can use the
Java-based NetBackup Administration Console to access the various servers.
This console is available on Java-capable UNIX platforms, as well as on Windows
platforms where the Java Windows Administration Console is installed.
See About using the Java Windows Administration Console on page 41.
The Java-based NetBackup Administration Console is backward-compatible in
the following situations:

Backward compatibility using triple-dot versions

Backward compatibility using single-dot versions with jnbSA -r

Backward compatibility using 7.6.1 with jnbSA -r

Backward compatibility using triple-dot versions

The Java-based NetBackup Administration Console is backward-compatible
from the console of a x.x.x.x (triple-dot) NetBackup server to the console of any
release that shares the same first and second digits.
For example, a NetBackup 7.6.0.2 console can administer a NetBackup 7.6 master
server. However, a NetBackup 7.6.0.2 console cannot administer a 7.5.0.7 master
server because the second digits are not the same. Figure 1-4 shows examples of
each.

43

Introducing NetBackup interfaces

About NetBackup administration interfaces

Figure 1-4

Examples of supported and unsupported back-level console

configurations

7.6.0.2

7.6.0.2

7.5.0.7

7.1.0.7

Yes

No

Yes

No

7.6

7.5.0.7

7.5

7.5

See the NetBackup Installation Guide for information about installing earlier versions
of the Java-based NetBackup Administration Console.

Backward compatibility using single-dot versions with jnbSA

-r
The Java-based NetBackup Administration Console offers backward compatibility
between single-dot releases when the -r option is used with the jnbSA command
to start the console.
Note: NetBackup 7.6.1 also allows backward compatibility using the -r option, even
though it is a double-dot release.
See the section called Backward compatibility using 7.6.1 with jnbSA -r on page 45.
The -r option allows an x.x Java-based NetBackup Administration Console to
connect to another UNIX master server that is several versions earlier, regardless
of whether the second digit is the same.
For example, a 7.6 Java-based NetBackup Administration Console can connect
to a NetBackup master server at version 7.5, 7.1, or 7.0. Figure 1-5 shows two
examples of back-level console support.
Use the -r option to launch the console on the UNIX system as follows:
./jnbSA -r release_version

For example, to connect to a 7.1 master server from a 7.6 master server, enter the
following command on the 7.6 master server to start the 7.1 console:
./jnbSA -r 7.1

If no -r option is specified, the default is the NetBackup version of the current

master server.

44

Introducing NetBackup interfaces

Using the NetBackup Administration Console

Figure 1-5

Examples of Java-based NetBackup Administration Console

back-level support using the jnbSA -r option

7.6

7.5

Yes

Yes

7.1

7.1

Backward compatibility using 7.6.1 with jnbSA -r

NetBackup 7.6.1 can also use the -r option with the jnbSA command to access a
master server at version 7.6, 7.5, 7.1, or 7.0.
Figure 1-6

Back-level support for 7.6.1 Java-based NetBackup Administration

Console

7.6.1

7.6.1

7.6.1

Yes

Yes

Yes

7.6

7.5

7.0

See Accessing remote servers on page 1115.

Using the NetBackup Administration Console

The NetBackup Administration Console provides a graphical user interface
through which the administrator can manage NetBackup.
The Windows-based NetBackup Administration Console is offered on the
computers that run Windows.

45

Introducing NetBackup interfaces

Using the NetBackup Administration Console

NetBackup Administration Console on Windows

Figure 1-7

1
2
3
4
5

6
7

8
9

10

11

A Java-based NetBackup Administration Console is offered on the computers

that run UNIX and that are Java-capable. The Java-based NetBackup
Administration Console can also be run on Windows if the Java Windows
Administration Console is installed.

46

Introducing NetBackup interfaces

Using the NetBackup Administration Console

Java-based NetBackup Administration Console

Figure 1-8

1
2
3
4
5
6
7

10

11

Table 1-2

NetBackup Administration Console description

Description
1

The name of the currently selected master server.

The information in the NetBackup Administration Console applies to this server only.

47

Introducing NetBackup interfaces

Using the NetBackup Administration Console

Table 1-2

NetBackup Administration Console description (continued)

Description
2

Backup, Archive, and Restore

Administrators can use the Backup, Archive, and Restore utility to back up, archive, and restore files, directories,
and the formatted raw partitions that reside on the computer that is currently selected. Files can be restored at
any time. However, files can be backed up or archived only during the time periods that the administrator defines
within a schedule for user backups. Users can view the progress and final status of the operations performed.
This node appears only on the Java-based NetBackup Administration Console. Use the Backup, Archive, and
Restore interface to perform the client actions for the host.
To open the interface on Windows, select File > Backup, Archive, and Restore.

Note: An archive is a special type of backup. During an archive, NetBackup first backs up the selected files, then
deletes the files from the local disk if the backup is successful. In this manual, references to backups also apply
to the backup portion of archive operations (except where otherwise noted).
Documentation for the NetBackup client is available as online Help from the Backup, Archive, and Restore
interface.
3

Activity Monitor
Displays the NetBackup job information. The Activity Monitor provides the control over the jobs, services,
processes, and drives.

NetBackup Management
The NetBackup Management contains many of the utilities to manage NetBackup:
Reports
Use to compile information to verify, manage, and troubleshoot NetBackup operations.
See About the Reports utility on page 1070.

48

Introducing NetBackup interfaces

Using the NetBackup Administration Console

Table 1-2

NetBackup Administration Console description (continued)

Description
Policies
Use to create and specify the backup policies that define the rules for backing up a group of clients.
For example, the backup policy specifies when automatic backups occur for the clients that are specified in the
policy. The backup policy also specifies whether users can perform their own backups and when. The administrator
can define any number of backup policies, each of which can apply to one or more clients. A NetBackup client
must belong to at least one backup policy to be backed up.
See About the Policies utility on page 653.
Storage
Use to configure storage units, storage unit groups, storage lifecycle policies (SLPs), and windows for secondary
operations in SLPs.
See About the Storage utility on page 535.
Catalog
Use to create and configure a catalog backup, which is a special type of backup that NetBackup requires for its
own internal databases.
These databases, called the NetBackup catalog, are located on the NetBackup master and media server. The
catalog contains information on every client backup. Catalog backups are tracked separately from other backups
to ensure recovery in case of a server crash.
The Catalog utility is also used for the following actions:

To duplicate a backup image

To promote a backup image from a copy to the primary backup copy

To manually expire backup images

To import expired backup images or images from another NetBackup server

To search for a backup image to verify the contents of the media with what is recorded in the NetBackup
catalog

See About the Catalog utility on page 947.

49

Introducing NetBackup interfaces

Using the NetBackup Administration Console

Table 1-2

NetBackup Administration Console description (continued)

Description
Host Properties
Use to customize NetBackup configuration options. In most instances, no changes are necessary. However, Host
Properties lets the administrator customize NetBackup to meet specific site preferences and requirements for
master servers, media servers, and clients.
The Host Properties also contain the properties to configure a server for indexing within the Indexing Servers
properties. NetBackup Search must first be installed on a NetBackup client or media server to configure an
indexing server. With NetBackup Search, the file system metadata that is associated with backup images can be
indexed. The indexed images can in turn be found quickly and placed on hold, if necessary.
For information about how to configure indexing for the NetBackup Search option, see the NetBackup Search
Administrators Guide.
See About the NetBackup Host Properties on page 64.
5

SLP Windows
SLP Windows contains any schedules that are defined for secondary operations in a storage lifecycle policy.
A window can better define when the job for a secondary operation can run, making sure that the job does not
interfere with jobs of a higher priority.

Applications
Applications contains all discovered instances on Oracle clients and any manually added instances. These
instances are used to build an Oracle Intelligent Policy.
For more information, see the NetBackup for Oracle Administrators Guide.

50

Introducing NetBackup interfaces

Using the NetBackup Administration Console

Table 1-2

NetBackup Administration Console description (continued)

Description
7

Media and Device Management

Contains the utilities for managing the media and devices that NetBackup uses to store backups:
Device Monitor
Manages drives, device paths, and service requests for operators.
Media
Adds and manages removable media.
Devices
Adds, configures, and manages storage devices.
Credentials
Adds, removes, and manages log on credentials for the following:

NDMP hosts (requires the NetBackup for NDMP license).

Storage servers (requires a NetBackup Data Protection Optimization Option license).

Credentials appears only if one of these license keys is installed.

8

Access Management
NetBackup administrators can protect a NetBackup configuration by defining who may access NetBackup and
what functions a user group can perform. Access Management is enabled when NetBackup Product Authentication
and Authorization and NetBackup Access Control (NBAC) is configured.
For more information about NetBackup Access Control, see the NetBackup Security and Encryption Guide.

Logging Assistant
The Logging Assistant is a tool that helps administrators configure, gather, and upload debug logs.
See About the Logging Assistant on page 1077.

10 Additional licensed utilities appear under the main NetBackup nodes.

11 The Details pane contains the configuration wizards and details specific to the utility that is selected.

On UNIX master servers, you can also administer NetBackup through a

character-based, menu interface (bpadm). This interface is described in the
NetBackup Administrators Guide, Volume II.
The NetBackup Administration Console menus are described in the online Help.

51

Introducing NetBackup interfaces

NetBackup configuration wizards

Standard and user toolbars

Upon opening the NetBackup Administration Console, a standard toolbar appears
by default.
When certain utilities are selected, a user toolbar appears. The buttons on the
toolbar provide shortcuts for menu commands. Slowly drag the pointer over a button
to display a button description label.
To display or hide the standard NetBackup toolbar, either click View > Toolbar (on
Windows) or click View > Show Toolbar (on UNIX).

About customizing the NetBackup Administration Console

The View menu contains options to customize the NetBackup Administration
Console.
For example, the Options selection opens a series of tabs that contain various
configuration options for the different utilities.
Select the Administration Console tab or the Administrative Options tab to
configure the Auto log off timeout option. Use this option to automatically log a
user out of the NetBackup Administration Console after a period of inactivity.
Click the Help button for more information about the dialog box options.

NetBackup configuration wizards

The easiest way to configure NetBackup is to use the configuration wizards available
in the NetBackup Administration Console. The wizards help configure the basic
properties of a NetBackup environment.
The wizard selection varies in the pane on the right, depending on which NetBackup
utility is selected in the left of the screen.

52

Introducing NetBackup interfaces

NetBackup configuration wizards

Configuration wizards

Table 1-3
Wizard

Description

Getting Started Wizard

Configures NetBackup for the first time. The wizard leads the user through the
necessary steps to a working NetBackup configuration.
The Getting Started Wizard is comprised of the following wizards, which can also
be run separately, outside of the Getting Started Wizard:

Device Configuration Wizard

Volume Configuration Wizard

Catalog Backup Wizard

Policy Configuration Wizard

Configure more advanced properties through the individual utilities.

Note: Do not use the Getting Started Wizard to configure policies for Replication
Director.
Device Configuration Wizard

Click Configure Storage Devices to configure NetBackup to use robotic tape

libraries and tape drives.

Storage Server Configuration

Wizard

Click Configure Disk Storage Servers to create the servers that manage disk
storage.
The wizard appears if a NetBackup Data Protection Optimization Option license
is installed.

Cloud Storage Server

Configuration Wizard

Click Configure Cloud Storage Servers to add or configure a cloud provider.

Disk Pool Configuration Wizard

Click Configure Disk Pool to create pools of disk volumes for backup by one or
more media servers.

For more information, see the NetBackup Cloud Administrator's Guide.

The wizard appears if a NetBackup Data Protection Optimization Option license

is installed.
Volume Configuration Wizard

Click Configure Volumes to configure removable media to use for backups.

Catalog Backup Wizard

Click Configure the Catalog Backup to set up catalog backups. Catalog backups
are essential to recover data in the case of a server failure or crash.

53

Introducing NetBackup interfaces

Running the Troubleshooter

Table 1-3

Configuration wizards (continued)

Wizard

Description

Policy Configuration Wizard

Click Create a Policy to set up one of the policy types:

A policy to back up file systems, databases, or applications.

A policy to protect VMware or Hyper-V virtual machines.

A policy to back up NDMP hosts.

A policy to back up Oracle data.

Note: Do not use the Policy Configuration Wizard to configure policies for
Replication Director.
Import Images Wizard

This wizard is available only on computers running Windows. Click Import Images
to import NetBackup images in a two-part process.
See About importing backup images on page 963.

Catalog Recovery Wizard

Click Recover the Catalog to recover a catalog backup in a disaster recovery

situation.
For more information about NetBackup disaster recovery, see the NetBackup
Troubleshooting Guide.

Running the Troubleshooter

When a NetBackup job returns a status code, use the Troubleshooter to find a
description of the problem and a recommended solution. The Troubleshooter is
particularly useful for understanding the status of a job in the Activity Monitor or
in the Reports utility.
To run the Troubleshooter

In the NetBackup Administration Console, do one of the following:

To understand the status of a
job in the Activity Monitor

In the left pane, click Activity Monitor.

In the right pane, select the Jobs tab at the bottom
of the pane.
Select a job from the list.

54

Introducing NetBackup interfaces

Running the Troubleshooter

To understand the status of a

job in a report

In the left pane, expand NetBackup Management

> Reports.
In the left pane, click the name of the report you want
to run.
For some reports, you must first expand a report
group, and then click the name of the report.
In the right pane, click Run Report.

Select a job from the list that is generated.

To look up a status code

Go to step 2.

Click Help > Troubleshooter.

The dialog box that appears describes the status code on the Problem tab.
Possible solutions can be found on the Troubleshoot tab. The Symantec
Support tab displays the Web address of Symantec Support or the URL to a
technote that addresses the specific error code.

If no explanation appears, enter a status code and click Lookup.

The Troubleshooter provides assistance for NetBackup codes only. Assistance
with Media and Device Management codes is available by using NetBackup
online Help and searching for the particular status code.

See Viewing job details in the Activity Monitor on page 1021.

See About the Jobs tab on page 1019.

55

Chapter

Administering NetBackup
licenses
This chapter includes the following topics:

About administering NetBackup licenses

About administering NetBackup licenses

License keys are added when the software is installed. Licenses can be added later
in the License Key dialog box for separately-priced options.
Note: Restart the NetBackup Administration Console after any license updates.

Note: Perform a manual catalog backup after updating license keys.

An immediate, manual catalog backup prevents stale keys from being restored in
case a catalog restore is necessary before the next scheduled catalog backup.
See Backing up NetBackup catalogs manually on page 876.
Perform the following tasks from the NetBackup License Keys dialog box:
Add a new license.

Adding NetBackup license keys

Print a license.

Printing a NetBackup license key list

Delete a license.

Deleting NetBackup license keys

View the properties of one Viewing NetBackup license key properties

license.

Administering NetBackup licenses

About administering NetBackup licenses

Export the license list.

Exporting NetBackup license keys

On computers running UNIX, the license key utility is a menu-driven interface and
can also be used to access licenses.
Starting the NetBackup license key utility on a UNIX computer

Accessing license keys for a NetBackup server

Use the following procedure to access license keys for a NetBackup server.
To access license keys for a NetBackup server

To view the license keys of the current server:

In the NetBackup Administration Console, in the toolbar, click Help > License
Keys.
To view the license keys of another server:
In the NetBackup Administration Console, in the toolbar, click File > Change
Server, select another server, and click OK. In the toolbar, click Help > License
Keys in the remote server.

Select the license details to view as follows:

Summary of
active licensed
features

Displays a summary of the active features that are licensed on

this server. This view lists each feature and the number of
instances of the feature that are licensed.

All registered
license keys
details

Displays the details of the license keys that are registered on this
server.
The view lists the following:

Each license key

The server where the key is registered

When the key was registered,

The features that the key provides

Adding NetBackup license keys

Use the following procedure to add NetBackup license keys to the selected server.
To add new license keys to the selected server

In the toolbar in the NetBackup Administration Console, click Help > License
Keys.

Click New.

57

Administering NetBackup licenses

About administering NetBackup licenses

Enter the license key and click Add or OK.

If you added a license on a computer running UNIX , restart all of the NetBackup
utilities. Restart the NetBackup Administration Console as well.

Perform a manual catalog backup after updating license keys.

An immediate, manual catalog backup prevents stale keys from being restored
in case a catalog restore is necessary before the next scheduled catalog
backup.
See Backing up NetBackup catalogs manually on page 876.

You can add license keys to a remote NetBackup server. In the NetBackup
Administration Console, select File > Change Server, then select another server
and click OK. Click Help > License Keys in the remote server.

Printing a NetBackup license key list

Use the following procedure to print a list of license keys that are installed on a
NetBackup server.
To print a list of license keys

In the toolbar in the NetBackup Administration Console, click Help > License
Keys.

In the NetBackup License Keys dialog box, select the license key you want
to print. If no selection is made, all licenses print.
The printed information includes the following:

License key

Name of the host

Date the key was added

Name of the product

Number of instances

Name of the feature

Whether or not the license is valid

Expiration date for the license

In the NetBackup License Keys dialog box, click the Print button.

Make the print selections and click OK.

58

Administering NetBackup licenses

About administering NetBackup licenses

Deleting NetBackup license keys

Use the following procedure to delete a license key that is installed on a NetBackup
server.
To delete a license key

In the toolbar in the NetBackup Administration Console, click Help > License
Keys.

In the NetBackup License Keys dialog box, select the license key you want
to delete from the license key list. If the key has more than one feature, all the
features are listed in the dialog box.

In the NetBackup License Keys dialog box, click the Delete button.

Click OK or Yes to delete the key and all features that are associated with the
key. The license key cannot be restored.
If you deleted a license on a computer running UNIX, restart all of the
NetBackup utilities. Restart the NetBackup Administration Console as well.

Viewing NetBackup license key properties

Use the following procedure to view the properties of a NetBackup license key.
To view the properties of a NetBackup license key

In the toolbar in the NetBackup Administration Console, click Help > License
Keys.
Select one license and click the Properties button.

Exporting NetBackup license keys

Use the following procedure to export NetBackup license keys.
To export NetBackup license keys

In the toolbar in the NetBackup Administration Console, click Help > License
Keys.

In the NetBackup License Keys dialog box, click the Export button.

In the Save As dialog box, enter the path and the file name where you want
the key properties of all licenses to be exported.

Click Save.
The exported file contains a list of each license key, along with the:

Name of the host

Date the license was added

Name of the product

59

Administering NetBackup licenses

About administering NetBackup licenses

Number of instances

Name of the feature

Whether or not the license is valid

Expiration date for the license

Starting the NetBackup license key utility on a UNIX computer

Use the following procedure to start the NetBackup license key utility on a computer
running UNIX.
To start the NetBackup license key utility on a computer running UNIX

From the command line, run

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

At the prompt, enter one of the following menu selections, then press Enter:

Type A to add a new license key, then type the license key at the prompt.

Type D to delete a license from the list, then type the license key at the
prompt.

Type F to list only the licenses that are currently active. Expired licenses
do not appear in this listing. Specify a local or a remote host.

Type L to list all registered licensesactive or inactive. Specify a local or

a remote host.

Type H for help on the License Key Utility.

Type q to quit the utility.

60

Section

Configuring hosts

Chapter 3. Configuring Host Properties

Chapter 4. Configuring server groups

Chapter 5. Configuring host credentials

Chapter 6. Managing media servers

Chapter

Configuring Host Properties

This chapter includes the following topics:

About the NetBackup Host Properties

About configuring Indexing Servers

Access Control properties

Active Directory host properties

Backup Exec Tape Reader properties

Bandwidth properties

Busy File Settings properties

Clean-up properties

Client Name properties

Client Attributes properties

Client Settings properties for UNIX clients

Client Settings properties for Windows clients

Credential Access properties

Data Classification properties

Default Job Priorities properties

Distributed application restore mapping properties

Encryption properties

Enterprise Vault properties

Configuring Host Properties

Enterprise Vault Hosts properties

Exchange properties

Exclude Lists properties

Fibre Transport properties

Firewall properties

General Server properties

Global Attributes properties

Logging properties

Login Banner Configuration properties

Lotus Notes properties

Media properties

NDMP Global Credentials properties

Network properties

Network Settings Properties

Port Ranges properties

Preferred Network properties

Resilient Network properties

Resource Limit properties

Restore Failover properties

Retention Periods properties

Scalable Storage properties

Servers properties

SharePoint properties

SLP Parameters properties

Symantec Products properties

Throttle Bandwidth properties

Timeouts properties

63

Configuring Host Properties

About the NetBackup Host Properties

Universal Settings properties

UNIX Client properties

UNIX Server properties

VMware Access Hosts properties

Windows Client properties

Configuration options not found in the Host Properties

About using commands to change the configuration options on UNIX clients

and servers

Configuration options for NetBackup servers

Configuration options for NetBackup clients

About the NetBackup Host Properties

The configuration options within the Host Properties let an administrator customize
NetBackup to meet specific site preferences and requirements. The Host Properties
also contain the properties to configure a server for indexing within the Indexing
Servers properties.
In most NetBackup environments, the Host Properties default settings provide
satisfactory results and can be left at the default setting.
For information about how to configure indexing for the NetBackup Search option,
see the NetBackup Search Administrators Guide.
Figure 3-1 shows the Host Properties in the NetBackup Administration Console
on Windows.

64

Configuring Host Properties

About the NetBackup Host Properties

Figure 3-1

Host Properties utility in the Windows NetBackup Administration

Console

1
2

Figure 3-2 shows the Host Properties in the Java-capable NetBackup

Administration Console on UNIX.
Figure 3-2

Host Properties utility in the Java-capable NetBackup

Administration Console

1
4

2
3

65

Configuring Host Properties

About the NetBackup Host Properties

Host Properties utility

Table 3-1

Number Description
1

The menu toolbar.

The standard NetBackup toolbar.

See Standard and user toolbars on page 52.

The name of the currently selected master server.

The user toolbar is specific to the Host Properties utility.

By default, the Host Properties user toolbar includes the following buttons:

Select a host in the right pane and click Properties to view the properties of
that host.
Select a host in the right pane and click Connect to connect to that host.

Click Configure media server to name a media server and view its properties.

Click Configure Client to name a client and view its properties.

Click Configure Indexing Server to name an indexing server and view its
properties.
See About configuring Indexing Servers on page 72.

You can select which buttons appear on the user toolbar.

See Standard and user toolbars on page 52.
5

Right-click in the right pane to view the shortcut menu.

To change the properties of another client or server, the NetBackup server where
you logged on using the NetBackup Administration Console must be in the
Servers list on the other system.
See Servers properties on page 229.
See About adding a NetBackup server to a server list on page 1116.
For example, if you logged on to server_1 using the NetBackup Administration
Console and want to change a setting on client_2, client_2 must include server_1
in its Servers list.
Note: All updates to a destination host fail if Allow server file writes is not enabled
on the destination host. This property is located in the Universal Settings properties.
See Universal Settings properties on page 253.

66

Configuring Host Properties

About the NetBackup Host Properties

Generally, these options are configured in the NetBackup Administration Console,

under Host Properties. However, some options cannot be configured by using the
NetBackup Administration Console.
See Configuration options not found in the Host Properties on page 261.

Methods to set the NetBackup configuration options

A NetBackup administrator can use one of the following methods to read or set the
default configuration options or to change those options that do not appear in the
Host Properties:
Table 3-2

NetBackup Host Properties configuration methods

Method

Description

NetBackup Administration Most properties are listed in the NetBackup Administration

Console interface
Console in the Host Properties. To navigate to the various
properties, select NetBackup Management > Host
Properties. Depending on the host to be configured, select
Master Servers, Media Servers, or Clients.
See About the NetBackup Host Properties on page 64.
Command line

Use the nbgetconfig command or bpgetconfig

command to obtain a list of configuration entries. Then use
nbsetconfig or bpsetconfig to change the options as
needed.
These commands update the appropriate configuration files
on both Windows (registry) and UNIX (bp.conf file) master
servers and clients.
Use the nbemmcmd command to modify some options on
hosts.
Detailed information on these commands is available in the
NetBackup Commands Reference Guide.

vm.conf file

The vm.conf file contains configuration entries for media

and device management.
See the NetBackup Administrator's Guide, Volume II for more
information.

Backup, Archive, and

Restore client interface

Administrators can specify configuration options for

NetBackup clients.
See the NetBackup Backup, Archive, and Restore Getting
Started Guide.

67

Configuring Host Properties

About the NetBackup Host Properties

Viewing host properties

The NetBackup Administration Console displays properties for NetBackup master
servers, media servers, and clients under Host Properties.
Use the following procedure to view master server, media server, or client properties.
To view master server, media server, or client properties

In the NetBackup Administration Console, expand NetBackup Management

> Host Properties.

Select Master Server, Media Server, or Clients.

View the properties:

In the Windows NetBackup Administration Console, in the right pane,

double-click the server or client to view the properties.

In the NetBackup Administration Console on a Java-capable UNIX

computer:
In the right pane, click the server or client to view the version and platform.
Then double-click to view the properties.

To see the properties of a different master server, click File > Change Server.

Changing the host properties on multiple hosts at the same time

You can select more than one host and change multiple hosts at one time. Use the
following procedure to change properties on multiple hosts at the same time.
To simultaneously change the properties on multiple hosts

In the NetBackup Administration Console, expand NetBackup Management

> Host Properties.

Select Master Server, Media Server, or Clients.

In the right pane, select a host. Hold down the Shift key and select another
host.

With multiple hosts still selected, click Actions > Properties.

The properties dialog box displays the names of the selected hosts that are
affected by subsequent host property changes.

68

Configuring Host Properties

About the NetBackup Host Properties

Number of hosts selected

The following information about each selected host appears:

Server or client name

Operating system

Type of computer in the configuration

Identifier

IP address

Make changes as necessary.

Click OK to save the changes for all hosts and to close the dialog box.

Property states for multiple hosts

The Host Properties dialog boxes use the following conventions regarding multiple
host selections:
Title of dialog box

If a dialog box contains a Selected Host (or similarly named)

box, all controls reflect the values for the host currently
selected in the Selected Host box.
If a dialog box does not contain a Selected Host (or similarly
named) box, settings of all the selected hosts are combined
to arrive at a value that is displayed to the user.

Option selection

When multiple hosts are selected, no options appear selected.

Selecting any option updates the setting on all selected hosts.
To leave each host configured independently, do not select
any option while multiple hosts are selected.

Number spinners

When multiple hosts are selected, number spinners appear

blank. Selecting any value updates the setting on all selected
hosts. To leave each host configured independently, do not
select any option while multiple hosts are selected.

69

Configuring Host Properties

About the NetBackup Host Properties

Check box states

The host property check boxes may appear in one of the

following states:

Edit field states

Selected (checked) if the attribute has been set the same

for all selected hosts. To set the property on all selected
hosts, select the check box.
Clear (unchecked) if the property has been set the same
for all selected hosts. To clear the property on all selected
hosts, clear the check box.
Gray check if the property is set differently on the selected
hosts. To leave the property unchanged, set the box to a
gray check.

If the property contains a text field for specifying a value, the

field may be in one of the following states:

The field may contain a value if the property has the same
value for all selected hosts.
The field may be empty or indicate <<Multiple Entries>>
if the property was not set the same for all selected hosts.
When the cursor is moved to such a field, a small notice
appears at the bottom of the dialog box noting that the
value is different on the selected hosts.

Note: In a clustered environment, host properties must be made on each node of

the cluster separately.

On Windows, if the property contains a text field for specifying a value, choose
from the following options:

To set the property to the same value for all selected hosts, check the
associated option and type the value in the field.

To leave the property unchanged, uncheck the associated option. The field
changes to gray.

On UNIX, if the focus is on a setting that is set differently between the multiple
selected hosts, the following statement appears at the bottom of the dialog box:
This value is different on the selected hosts.
This notice is especially helpful regarding differences in text field settings.

If the selected hosts are of various operating systems, none of the operating
system-specific information appears.
For example, select a Linux client and a Windows 2008 client. Neither the Windows
Client properties nor the UNIX Client properties appear in the Host Properties. If

70

Configuring Host Properties

About the NetBackup Host Properties

all the selected hosts are of the same operating system, the corresponding properties
node appears.

Exporting host properties

Use the following procedure to export the properties of a host.
To export the properties of a host

In the NetBackup Administration Console, expand NetBackup Management

> Host Properties > Master Servers, Media Servers, or Clients.

Select a host. If you want to select multiple hosts, hold down the Shift key and
select another host.

Click File > Export.

Save the file:

On Windows, in the Export Data dialog box, enter the full path name or
browse to the directory and click Save.

On UNIX, in the Save As dialog box, enter the full path name and click
Save.

Standard host property dialog box options

The following options are available in every host property dialog box.
Default

Click Default to set all the properties in the current dialog

box to the default values.

OK

Click OK to apply all changes since Apply was last clicked.

OK also closes the dialog box.

Cancel

Click Cancel to cancel the changes that were made since

the last time changes were applied.

Apply

Click Apply to save changes to all of the properties for the

selected host(s).
However, on Windows, click OK to apply changes.

Help

Click Help for information on the properties that appear in

the current dialog box.

71

Configuring Host Properties

About configuring Indexing Servers

About configuring Indexing Servers

The Host Properties also contain the properties to configure a server for indexing
within the Indexing Servers properties. NetBackup Search must first be installed
on a NetBackup client or media server to configure an indexing server. With
NetBackup Search, the file system metadata that is associated with backup images
can be indexed. The indexed images can in turn be found quickly and placed on
hold, if necessary.
For information about how to configure indexing for the NetBackup Search option,
see the NetBackup Search Administrators Guide.
See Enable indexing for search (policy attribute) on page 723.
See Indexing server (policy attribute) on page 724.
See Enable indexing for search (schedule attribute) on page 743.

Schedules properties
Use an indexing server's Schedules properties in the NetBackup Administration
Console to add, delete, or change the schedules for an indexing server.

72

Configuring Host Properties

About configuring Indexing Servers

Figure 3-3

Schedules dialog box for an indexing server

Table 3-3

Schedule (indexing server) dialog box properties

Property

Description

List of Schedules

The Name column lists the existing schedules for the indexing server.

New

Click New to create a new schedule for the indexing server. Provide the required schedule
information in the Add New Schedule dialog box.

Delete

Select a schedule from the list and click Delete to remove it from the indexing server
properties. The schedule is removed without a confirmation prompt. You cannot undo this
action.

Properties

Select a schedule from the list and click Properties to change a schedule. Update the
schedule information in the Change Schedule dialog box.

73

Configuring Host Properties

Access Control properties

Access Control properties

Use the Access Control host properties in the NetBackup Administration Console
to configure NetBackup Authentication and Authorization. The properties apply to
currently selected master servers, media servers, indexing servers, and clients.
The following tabs may display:

Authentication Domain tab

See Authentication Domain tab of the Access Control properties on page 75.

Authorization Service tab

See Authorization Service tab of the Access Control properties on page 76.

Network Attributes
See Network Attributes tab of the Access Control properties on page 77.

The tabs that display depend on whether the host that is selected is a master server,
a media server, or a client.
The NetBackup Product Authentication and Authorization property displays,
regardless of which tab is selected. It determines whether the local system uses
access control and how the system uses it.
The NetBackup Product Authentication and Authorization property contains
the following options.
Table 3-4

NetBackup Product Authentication and Authorization property

options

Option

Description

Required

Specifies that the local system should accept requests only from the remote systems that use
NetBackup authentication and authorization. Connections from the remote systems that do not
use NetBackup authentication and authorization are rejected. Select Required if all systems
are at NetBackup 5.0 or later and maximum security is required.

Prohibited

Specifies that the local system should reject connections from any remote system that uses
NetBackup authentication and authorization. Select Prohibited if the network is closed and
maximum performance is required.

Automatic

Specifies that the local system should negotiate with the remote system about whether to use
NetBackup authentication and authorization. Select Automatic if the network contains mixed
versions of NetBackup.

For more information about controlling access to NetBackup, see the NetBackup
Security and Encryption Guide.

74

Configuring Host Properties

Access Control properties

Authentication Domain tab of the Access Control properties

The Authentication Domain tab contains the properties that determine which
authentication broker a computer uses. A master server that uses NetBackup
authentication and authorization must have at least one authentication domain
entry.
Figure 3-4

Authentication Domain tab

If a media server or client does not define an authentication domain, it uses the
authentication domains of its master server.
The Authentication Domain tab on the Access Control dialog box contains the
following properties.
Table 3-5

Authentication Domain tab properties

Property

Description

Available Brokers

Select a broker, then click Find to list all of

the available authentication domains.

75

Configuring Host Properties

Access Control properties

Table 3-5

Authentication Domain tab properties (continued)

Property

Description

Available Authentication Domains list

List of available authentication domains.

Add button

Select the authentication domain(s) that this

host can use and click Add.

Selected Authentication Domains list

List of the authentication domains selected

for the host to use.

Remove button

Select the authentication domain(s) that you

no longer want to use and click Remove.

Authorization Service tab of the Access Control properties

The Authorization Service tab refers to the authorization service that the local
NetBackup server uses. The Authorization Service tab does not appear as a
property for clients.
Figure 3-5

Authorization Service tab

76

Configuring Host Properties

Access Control properties

The Authorization Service tab contains the following properties, which you can
configure for a master or a media server.
Table 3-6

Authorization Service property options

Option

Description

Host name

Specifies the host name or IP address of the authorization service.

Customize the port number of the

authorization service

Specifies a nonstandard port number. Select Customize the port

number and enter the port number of the authorization service.

Note: Define a host to perform authorization if you configure this tab for a media
server to use access control.

Network Attributes tab of the Access Control properties

The Network Attributes tab contains a list of networks that are allowed (or not
allowed) to use NetBackup authentication and authorization with the local system.

77

Configuring Host Properties

Access Control properties

Figure 3-6

Network Attributes tab

The Network Attributes tab on the Access Control dialog box contains the
following properties:
Networks

The Networks property indicates whether specific networks can or cannot use NetBackup
authentication and authorization with the local system. The names on the list are relevant
only if the NetBackup Product Authentication and Authorization property in the Access
Control dialog box is set to Automatic or Required.
Symantec recommends setting the master server NetBackup Product Authentication and
Authorization property to Automatic until the clients are configured for access control. Then,
change the NetBackup Product Authentication and Authorization property on the master
server to Required.
If a media server or client does not define a NetBackup Authentication and Authorization
network, it uses the networks of its master server.
Click Add to add a network to the Network list.
Click Add to All to add a network to all currently selected hosts in the Network list.
Select a network name and click Remove to remove a network from the Network list.

78

Configuring Host Properties

Access Control properties

NetBackup Product
Authentication and
Authorization
property

The NetBackup Product Authentication and Authorization property in this tab determines
whether the selected network uses access control and how the network uses it.
See Access Control properties on page 74.

Add Network dialog box

The Add Network dialog box contains the following properties.
Table 3-7

Add Network dialog box properties

Property

Description

Host/ Domain

Indicates whether the network to be added is a Host name or a Domain name.

Host Details

Specifies that if the network is a host, one of the following items must be entered:

Domain Details

The host name of the remote system. (host.domain.com)

The IP address of the remote system. (10.0.0.29)

Domain Name/IP

Enter a dot followed by the Internet domain name of the remote systems. (.domain) or
the network of the remote system, followed by a dot. (10.0.0.)
If the domain is specified by IP, select one of the following items:
Bit count
Indicates that the mask is based on bit count. Select from between 1 and 32.
For example: Mask 192.168.10.10/16 has the same meaning as subnet mask
192.168.20.20:255:255:0.0
Subnet mask
Select to enter a subnet mask in the same format as the IP address.

79

Configuring Host Properties

Active Directory host properties

Figure 3-7

Add Network dialog box

Active Directory host properties

The Active Directory properties in the NetBackup Administration Console apply
to the backup of currently selected Windows Server 2008 clients. The Active
Directory properties determine how the backups that allow Active Directory granular
restores are performed.
See Creating a policy that allows Active Directory granular restores on page 836.

80

Configuring Host Properties

Active Directory host properties

Figure 3-8

Active Directory dialog box

The Active Directory dialog box contains the following properties.

Table 3-8
Property

Active Directory dialog box properties

Description

Perform consistency check before backup Checks snapshots for data corruption. Applies only to snapshots that
when using Microsoft Volume Shadow Copy the Microsoft Volume Shadow Copy Services (VSS) performs.
Service snapshot provider
If corrupt data is found and this option is not selected, the job fails.
See Windows Open File Backup tab of the Client Attributes
properties on page 102.
Continue with backup if consistency check Continues the backup job even if the consistency check fails.
fails
It may be preferable for the job to continue, even if the consistency
check fails. For example, a backup of the database in its current state
may be better than no backup at all. Or, it may be preferable for the
backup of a large database to continue if it encounters only a small
problem.

81

Configuring Host Properties

Backup Exec Tape Reader properties

Backup Exec Tape Reader properties

The Backup Exec Tape Reader properties in the NetBackup Administration
Console let NetBackup read the media that Backup Exec writes. Media is read by
using a two-phase import process. The Backup Exec Tape Reader properties
apply to currently selected master servers.
Note: The Backup Exec Tape Reader functionality will not be supported in the
next major NetBackup release.
Figure 3-9

Backup Exec Reader dialog box

The Backup Exec Tape Reader dialog box contains the following properties.

82

Configuring Host Properties

Backup Exec Tape Reader properties

Table 3-9

Backup Exec Tape Reader dialog box properties

Property

Description

GRFS advertised name

Specifies the name that the Backup Exec UNIX agent uses to identify itself to the
Backup Exec server. The advertised name may not be the same as the real computer
name and path.
To set the correct client name and paths in Backup Exec UNIX images .f file paths,
map the master server between the GRFS advertised name (generic file system
name) and the actual client name and path.
The GRFS advertised name uses the following format:
ADVERTISED_HOST_NAME/advertised_path
where ADVERTISED_HOST_NAME is the advertised host name and advertised_path
is the advertised path. Enter the ADVERTISED_HOST_NAME in capital letters.
A Backup Exec service maps the advertised name to the actual computer name and
path, and then backs up the advertised name and path. When NetBackup imports
Backup Exec UNIX backups, the mapping service is not present; therefore the names
and paths must be indicated.
If the host properties do not list any entries, NetBackup assumes that the advertised
name is the same as the real computer name. NetBackup assumes that the advertised
path is the same as the real path.

Actual client name

Maps the advertised name to the real computer name.

If the host properties do not list any entries, NetBackup assumes that the advertised
name is the same as the real computer name. NetBackup assumes that the advertised
path is the same as the real path.

Actual path

Maps the advertised path to the real path.

If the host properties do not list any entries, NetBackup assumes that the advertised
name is the same as the real computer name. NetBackup assumes that the advertised
path is the same as the real path.

Add

Adds a GRFS entry. In the Backup Exec Tape Reader properties, click Add.

Change

Changes a selected GRFS entry. Select an entry in the Backup Exec Tape Reader
properties list and click Change.

Remove

Removes a GRFS entry. Select an entry in the Backup Exec Tape Reader properties
list and click Remove.

See About importing backup images on page 963.

83

Configuring Host Properties

Bandwidth properties

Bandwidth properties
Use the Bandwidth properties to specify network bandwidth limits for the NetBackup
clients of the selected server.
Note: The Bandwidth properties apply only to IPv4 networks. Use the Throttle
Bandwidth properties to limit IPv6 networks.
See Throttle Bandwidth properties on page 249.
The actual limiting occurs on the client side of the backup connection. The bandwidth
limits only restrict bandwidth during backups. By default, the bandwidth is not limited.
The Bandwidth properties apply to currently selected master servers.
Figure 3-10

Bandwidth dialog box

To manage entries in the Bandwidth dialog box, select one of the following buttons.
Add

Adds an entry to the bandwidth table for each of the selected clients.

84

Configuring Host Properties

Bandwidth properties

Change

Changes an entry to the bandwidth table for each of the selected

clients.

Remove

Removes the selected entry from the bandwidth table.

When a backup starts, NetBackup reads the bandwidth limit configuration as

configured in the Bandwidth host properties. NetBackup then determines the
appropriate bandwidth value and passes it to the client. NetBackup computes the
bandwidth for each new job based on the number of jobs that are currently running
for the IP range. The bandwidth value that is assigned to the job at start time remains
the same until the job is completed.NetBackup does not include local backups in
its calculations.
The NetBackup client software enforces the bandwidth limit. Before a buffer is
written to the network, client software calculates the current value for kilobytes per
second and adjusts its transfer rate if necessary.

Bandwidth limit usage considerations and restrictions

Some usage restrictions apply to the bandwidth limit settings in the Bandwidth
dialog box. The following table lists the restrictions and describes specific behaviors
that you may need to consider.
Table 3-10

Bandwidth limit usage considerations and restrictions

Client or operation

AFS

DataTools SQL-BackTrack

DB2

Enterprise-Vault

FlashBackup

FlashBackup-Windows

Lotus-Notes

MS-SharePoint

MS-SQL-Server

NCR-Teradata

NDMP

SAP

Vault

Local backups

Bandwidth limit behavior or restrictions

Bandwidth limits do not apply to these policy
types.

If a server is also a client and data does not

go over the network, bandwidth limits have
no effect on local backups.

85

Configuring Host Properties

Busy File Settings properties

Table 3-10

Bandwidth limit usage considerations and restrictions (continued)

Client or operation

Bandwidth limit behavior or restrictions

Setting required bandwidth

Bandwidth limits restrict maximum network

usage and do not imply required bandwidth.
For example, if you set the bandwidth limit
for a client to 500 kilobytes per second, the
client can use up to that limit. It does not
mean, however, that the client requires 500
kilobytes per second.

Distributing the workload of active backups

You cannot use bandwidth limits to distribute

the backup workload of active backups by
having NetBackup pick the most available
network segment. NetBackup does not pick
the next client to run based on any configured
bandwidth limits.

Add Bandwidth Settings dialog box for Bandwidth properties

The Add Bandwidth Settings and the Change Bandwidth Settings dialog boxes
contain the following properties.
From Host

Specifies the beginning of the IP address range of the

clients and networks to which the entry applies. For
example: 10.1.1.2

To Host

Specifies the end of the IP address range of the clients

and networks to which the entry applies. For example:
10.1.1.9

Bandwidth (KB/Sec)

Specifies the bandwidth limitation in kilobytes per second.

A value of 0 disables the limits for an individual client or
the range of IP addresses covered by the entry. For
example, a value of 200 indicates 200 kilobytes per second.

Busy File Settings properties

The Busy File Settings properties in the NetBackup Administration Console
apply to currently selected UNIX clients. The Busy File Settings properties define
what occurs when NetBackup encounters a busy file during a backup of a UNIX
client.

86

Configuring Host Properties

Busy File Settings properties

Figure 3-11

Busy File Settings dialog box

The Busy File Settings dialog box contains the following properties.
Table 3-11

Busy File Settings dialog box properties

Property

Description

Working directory

Specifies the path to the busy-files working directory. On a UNIX client, the value in the
users $HOME/bp.conf file takes precedence if it exists. By default, NetBackup creates
the busy_files directory in the /usr/openv/netbackup directory.

Operator's email
address

Specifies the recipient of the busy-file notification message when the action is set to Send
email. By default, the mail recipient is the administrator. On a UNIX client, the value in the
users $HOME/bp.conf file takes precedence if it exists. By default,
BUSY_FILE_NOTIFY_USER is not in any bp.conf file and the mail recipient is root.

Process busy files

Enables busy files to be processed according to the host property settings. NetBackup
follows the Busy File Settings if it determines that a file is changing during a backup. By
default, Process busy files is not enabled and NetBackup does not process the busy files.
Additional information about busy file processing is available in the NetBackup
Administrators Guide, Volume II.

87

Configuring Host Properties

Busy File Settings properties

Table 3-11

Busy File Settings dialog box properties (continued)

Property

Description

File action file list

Specifies the absolute path and file name of the busy file. The metacharacters *, ?, [], [ - ]
can be used for pattern matching of file names or parts of file names.

Add

Adds a new file entry. Enter the file and path directly, or browse to select a file.

Add to All

Adds a new file entry for all of the clients currently selected. Enter the file and path directly,
or browse to select a file.

Remove

Removes the selected file from the file action list.

Busy file action

The following options specify which action to take when busy-file processing is enabled.
On a UNIX client, the value in the users $HOME/bp.conf file takes precedence if it exists.

Retry count

Send email sends a busy sends a busy file notification message to the user that is
specified in Operators email address.
Retry the backup retries the backup on the specified busy file. The Retry count value
determines the number of times NetBackup tries a backup.
Ignore excludes the busy file from busy file processing. The file is backed up, then a
log entry that indicates it was busy appears in the All Log Entries report.

Specifies the number of times to try the backup. The default retry count is 1.

Activating the Busy File Settings in host properties

To activate the settings in the Busy File Settings host properties, use the following
procedure.
To activate Busy File Settings

Copy the bpend_notify_busy script:

/usr/openv/netbackup/bin/goodies/bpend_notify_busy

to the path:
/usr/openv/netbackup/bin/bpend_notify

Set the file access permissions to allow group and others to run bpend_notify.

Configure a policy with a user backup schedule for the busy file backups.
This policy services the backup requests that the repeat option in the actions
file generates. The policy name is significant. By default, NetBackup
alphabetically searches (uppercase characters first) for the first available policy
with a user backup schedule and an open backup window. For example, a
policy name of AAA_busy_files is selected ahead of B_policy.

88

Configuring Host Properties

Clean-up properties

Clean-up properties
The Clean-up properties in the NetBackup Administration Console refer to the
retention of various logs and incomplete jobs. The Clean-up properties apply to
currently selected master servers.
Figure 3-12

Clean-up dialog box

The Clean-up dialog box contains the following properties.

89

Configuring Host Properties

Clean-up properties

Table 3-12

Clean-up dialog box properties

Property

Description

Keep logs

Specifies how many days you want to keep the logs in case you need the
logs to evaluate failures. For example, if you check the backups every day,
you can delete the logs sooner than if you check the backups once a month.
However, the logs can consume a large amount of disk space, so do not
keep the logs any longer than necessary. The default is 28 days.
Specifies the length of time, in days, that the master server keeps its error
catalog, job catalog, and debug log information. NetBackup derives the
Backup Status, Problems, All Log Entries, and Media Log reports from the
error catalog. Also limits the time period that these reports can cover. When
this time expires, NetBackup also deletes these logs (that exist) on UNIX
media servers and UNIX clients.

Keep Vault logs

If Vault is installed, the Keep vault logs option is enabled. It specifies the
amount of time that the Vault session directories are kept.
Session directories are found in the following location:
install_path\netbackup\vault\sessions\vaultname\
session_x
where x is the session number. This directory contains vault log files,
temporary working files, and report files.

Image cleanup interval

Specifies the maximum interval that can elapse before an image cleanup is
run. Image cleanup is run after every successful backup session (that is, a
session in which at least one backup runs successfully). If a backup session
exceeds this maximum interval, an image cleanup is initiated.

Catalog cleanup wait time

Specifies the minimum interval that can elapse before an image cleanup is
run. Image cleanup is not run after a successful backup session until this
minimum interval has elapsed since the previous image cleanup.

90

Configuring Host Properties

Clean-up properties

Clean-up dialog box properties (continued)

Table 3-12
Property

Description

Keep true image restoration

information

Specifies the number of days to keep true image restore information on disk.
After the specified number of days, the images are pruned (removed). Applies
to all policies for which NetBackup collects true image restore information.
The default is one day.
When NetBackup performs a true image backup, it stores the following
images on the backup media:

Backed up files

True image restore information

NetBackup also stores the true image restore information on disk in the
following directories:
On Windows:
install_path\NetBackup\db\images
On UNIX:
/usr/openv/netbackup/db/images
NetBackup retains the information for the number of days that this property
specifies.
Keeping the information on disk speeds up restores. If a user requests a
true image restore after the information was deleted from disk, NetBackup
retrieves the required information from the media. The only noticeable
difference to the user is a slight increase in total restore time. NetBackup
deletes the additional information from disk again after one day.
Move restore job from incomplete
state to done state

Indicates the number of days that a failed restore job can remain in an
Incomplete state. After that time, the Activity Monitor shows the job as Done.
The default is 7 days. The maximum setting is 365 days. If Checkpoint Restart
for restores is used, the Restore retries property allows a failed restore job
to be retried automatically.
See Universal Settings properties on page 253.
See Checkpoint restart for restore jobs on page 682.

91

Configuring Host Properties

Client Name properties

Table 3-12

Clean-up dialog box properties (continued)

Property

Description

Move backup job from incomplete

state to done state

Indicates the maximum number of hours that a failed backup job can remain
in an incomplete state. After that time, the Activity Monitor shows the job as
Done. The minimum setting is one hour. The maximum setting is 72 hours.
The default is three hours.
When an active job has an error, the job goes into an Incomplete state. In
the Incomplete state, the administrator can correct the condition that caused
the error. If an Incomplete job does not complete successfully and is moved
to the Done state, the job retains the error status.

Note: A resumed job reuses the same job ID, but a restarted job receives
a new job ID. The job details indicate that the job was resumed or restarted.

Note: This property does not apply to suspended jobs. Suspended jobs
must be resumed manually before the retention period of the job is met and
the image expires. If a suspended job is resumed after the retention period
is met, the job fails and is moved to the Done state.

Client Name properties

The Client name property in the NetBackup Administration Console specifies
the NetBackup client name for the selected client. The name must match the name
the policy uses to back up the client. The only exception is for a redirected restore,
where the name must match that of the client whose files are to be restored. The
client name is initially set during installation.
The name that is entered here must also match the client name in the Client
Attributes dialog box for the master server. If it does not match, the client cannot
browse for its own backups.
Note: Using an IPv6 address as a client name in a policy can cause backups to fail.
Specify a hostname instead of an IPv6 address.
See Client Attributes properties on page 93.

92

Configuring Host Properties

Client Attributes properties

Figure 3-13

Client Name dialog box

If the value is not specified, NetBackup uses the name that is set in the following
locations:

For a Windows client

In the Network application from the Control Panel.

For a UNIX client

The name that is set by using the hostname command.
The name can also be added to a $HOME/bp.conf file on a UNIX client. However,
the name is normally added in this manner only for redirected restores. The
value in the $HOME/bp.conf file takes precedence if it exists.

Client Attributes properties

In the NetBackup Administration Console, the Client Attributes properties apply
to the clients of currently selected master servers.
The Global client attributes property applies to all clients, unless overridden as
described in the following table.

93

Configuring Host Properties

Client Attributes properties

Table 3-13

Global client attributes group box

Attribute

Description

Allow client browse

Allows all clients to browse files for restoring. This attribute is overridden if
the Browse and restore ability option on the General tab is set to Deny
both for a particular client(s).

Allow client restore

Allows all clients to restore files. This attribute is overridden if the Browse
and restore ability option on the General tab is set to Allow browse only
or Deny both.

Clients

Specifies the list of clients in the client database on the currently selected
master server(s). A client must be in the client database before you can
change the client properties in the Client Attributes dialog box.
The client database consists of directories and files in the following
directories:
On Windows: Install_path\NetBackup\db\client
On UNIX: /usr/openv/NetBackup/db/client
If a client is not listed in the Clients list, click Add to add clients. To remove
a client from the Clients list, select the client, then click Remove.
If a client is not listed in the Clients list, click Add to display the Add Client
dialog box and add a client to the client database. Type a client name in the
text box or click the browse button (...) and select a client.
See Add Client dialog box on page 95.
The name that is entered here must match the Client Name property for the
specific client. If it does not, the client cannot browse its own backups.
See Client Name properties on page 92.
Use the bpclient command to add clients to the client database if dynamic
addressing (DHCP) is in use.
Additional information about dynamic host names and IP addressing is
available in the NetBackup Administrators Guide, Volume II.
On UNIX: You also can create, update, list, and delete client entries by using
the bpclient command that is located in the following directory:
/usr/openv/netbackup/bin/admincmd

General tab

Specifies how to configure the selected Windows master servers (clients).

See General tab of the Client Attributes properties on page 95.

94

Configuring Host Properties

Client Attributes properties

Global client attributes group box (continued)

Table 3-13
Attribute

Description

Connect Options tab

Specifies how to configure the connection between a NetBackup server and

a NetBackup client.
See Connect Options tab of the Client Attributes properties on page 100.

Windows Open File Backup tab

Specifies whether a client uses Windows Open File Backup. Also, specifies
whether Volume Snapshot Provider or Volume Shadow Copy Service
is used as the snapshot provider.
See Windows Open File Backup tab of the Client Attributes properties
on page 102.

Add Client dialog box

To add a client to the database, enter the name of a client, or browse to find a client.
The Add Client dialog box contains the following properties.
Enter client name

Specifies the name of the client to be added to the database.

Type the name of the client to add.

... (browse)

Finds the list of current clients and displays them in the Browse
for computer window. Select the client to add to the database
and click Add.

Add

Adds the specified client to the client database (client name

displays in the Clients window).

Close

Closes the Add Client dialog box.

Help

Displays more information about how to add a client.

General tab of the Client Attributes properties

The properties on the General tab apply to selected Windows master servers. The
tab appears on the Client Attributes dialog box.

95

Configuring Host Properties

Client Attributes properties

Figure 3-14

General tab of Client Attributes dialog box

The General tab contains the following properties.

96

Configuring Host Properties

Client Attributes properties

General tab properties

Table 3-14
Property

Description

Offline Until:

Makes the specified clients in the General tab unavailable for backups. By
default, clients are online and included in the policies in which they are listed.
When Offline Until: is selected for a client, no jobs are scheduled for that
client. Since the client is not part of any job, no backup status will be listed
for the client.
After enabling the Offline Until: option, indicate the date and time when the
clients are to be online again. The default setting is infinity, or approximately
January 18, 2038, depending on the locale setting.
See Retention Periods with end dates beyond 2038, excluding Infinity
on page 224.

Note: Changes to this property do not appear in the audit report.

See About NetBackup auditing on page 1056.
The ability to take clients offline is useful in a number of situations.
See Offline option usage considerations and restrictions on page 98.
Maximum data streams

Specifies the maximum number of jobs that are allowed at one time for each
selected client. (This value applies to the number of jobs on the client, even
if multistreaming is not used.)
To change the setting, select Maximum data streams. Then scroll to or
enter a value up to 99.
The Maximum data streams property interacts with Maximum jobs per client
and Limit jobs per policy as follows:

If the Maximum data streams property is not set, the limit is either the
one indicated by the Maximum jobs per client property or the Limit
jobs per policy property, whichever is lower.
If the Maximum data streams property is set, NetBackup ignores the
Maximum jobs per client property. NetBackup uses either Maximum
data streams or Limit jobs per policy, whichever is lower.
See Global Attributes properties on page 158.
See Limit jobs per policy (policy attribute) on page 684.

97

Configuring Host Properties

Client Attributes properties

General tab properties (continued)

Table 3-14
Property

Description

Browse and restore ability

Specifies the client permissions to list and restore backups and archives.
Select the client(s) in the General tab of the Client Attributes dialog box
and choose a Browse and restore ability property.
To use the Global client attributes settings, select Use global settings.

Free browse

To allow users on the selected clients to both browse and restore, select
Allow both.
To allow users on the selected clients to browse but not restore, select
Allow browse only.
To prevent users on the selected clients from the ability to browse or
restore, select Deny both.

Specifies whether the clients can list and restore from scheduled backups.
(This setting does not affect user backups and archives.)
This property applies to the privileges that are allowed to a non-Windows
administrator or non-root user who is logged into the client. This property
also applies to the users that do not have backup and restore privileges.
Windows administrators and root users can list and restore from scheduled
backups as well as user backups regardless of the Free browse setting.

Deduplication

Specifies the deduplication action for clients if you use one of the following
NetBackup deduplication options:

NetBackup Data Protection Optimization Option

PureDisk Deduplication Option

For a description of the client-side deduplication options and their actions:

See Where deduplication should occur on page 99.

Offline option usage considerations and restrictions

The ability to take clients offline is useful in a number of situations. For example,
in the event of planned outages or maintenance, client systems can be taken offline
to avoid the unnecessary errors that administrators would then need to investigate.
This option can also be used to anticipate new clients in the system; listing them
in policies but configuring them as offline until they are in place and ready to be
used
The following actions can be performed if a client is offline.

98

Configuring Host Properties

Client Attributes properties

Table 3-15

Offline option actions

Type of job or operation

Action or restriction

A client is offline and the job is already in progress

Offline clients continue to be included in any job.

A client is offline and job retries were started before the Job retries continue as normal.
client was taken offline
Any duplication job that is associated with a storage
lifecycle policy and an offline client

Continues to run until complete.

LiveUpdate jobs for offline clients

Continues to run until complete.

Restore jobs

Can be run for offline clients.

The user attempts a manual backup for an offline client The backup fails with a status code 1000 (Client is offline).
The user can either wait until the client is brought online
again or bring the client online manually. Use either the
NetBackup Administration Console or the bpclient
command to do so before resubmitting the manual job.
Archive backups

Not allowed for offline clients.

Administrators restarting or resuming jobs

Not allowed for offline clients.

Caution: If the master server is offline, hot catalog backups cannot run.

Where deduplication should occur

The Deduplication property specifies the deduplication action for clients if you use
either the NetBackup Data Protection Optimization Option or the PureDisk
Deduplication Option. Table 3-16 describes the client-side deduplication options.
The clients that deduplicate their own data and the master server must use the
same name to resolve the storage server. The name must be the host name under
which the NetBackup Deduplication Engine credentials were created. If they do not
use the same name, backups fail. In some environments, careful configuration may
be required to ensure that the client and the master server use the same name for
the storage server. Such environments include those that use VLAN tagging and
those that use multi-homed hosts.
NetBackup does not support the following for client-side deduplication:

Multiple copies per job configured in a NetBackup backup policy. For the jobs
that specify multiple copies, the backup images are sent to the storage server
and may be deduplicated there.

99

Configuring Host Properties

Client Attributes properties

NDMP hosts. The backup jobs fail if you try to use client-side deduplication for
NDMP hosts.
Client-side deduplication options

Table 3-16
Option

Description

Always use the media server (the

default)

Always deduplicates the data on the media server. The default.

Jobs fail if one of the following is true:

The dedupliction services on the storage server are inactive.

The deduplication pool is down.

Prefer to use client-side deduplication Deduplicates data on the client and then sends it directly to the storage
server.
NetBackup first determines if the storage server is active. If it is active, the
client deduplicates the backup data and sends it to the storage server to be
written to disk. If it is not active, the client sends the backup data to a media
server, which deduplicates the data.
Always use client-side deduplication Always deduplicates the backup data on the client and then sends it directly
to the storage server.
If a job fails, NetBackup does not retry the job.

You can override the Prefer to use client-side deduplication or Always use
client-side deduplication host property in the backup policies.
See Disable client-side deduplication (policy attribute) on page 706.
More information about client deduplication is available.
See the NetBackup Deduplication Guide available through the following URL:
http://www.symantec.com/docs/DOC5332

Connect Options tab of the Client Attributes properties

The properties in the Connect Options tab describe how a NetBackup server
connects to NetBackup client tabs. The tab appears on the Client Attributes dialog
box.

100

Configuring Host Properties

Client Attributes properties

Figure 3-15

Connect Options tab of Client Attributes dialog box

The Connect Options tab contains the following options.

Table 3-17

Connect Options tab properties

Property

Description

BPCD connect back

Specifies how daemons are to connect back to the NetBackup Client daemon
(BPCD) and contains the following options:

Use default connect options

Uses the value that is defined in the Firewall host properties of the clients
NetBackup server.
See Firewall properties on page 150.
Random port
NetBackup randomly chooses a free port in the allowed range to perform the
legacy connect-back method.
VNETD port
NetBackup uses the vnetd port number for the connect-back method.

101

Configuring Host Properties

Client Attributes properties

Table 3-17

Connect Options tab properties (continued)

Property

Description

Ports

Specifies the method that the selected clients should use to connect to the server
and contains the following options:

Daemon connection port

Use default connect options

Uses the value that is defined in the Firewall host properties of the clients
NetBackup server.
See Firewall properties on page 150.
Reserved port
Uses a reserved port number.
Non-reserved port
Uses a non-reserved port number.

Specifies the method that the selected clients should use to connect to the server
and contains the following options.

Use default connect options

Uses the value that is defined in the Firewall host properties of the clients
NetBackup server.
Automatic
Connects to the daemons on the server using vnetd if possible. If the daemons
cannot use vnetd, the connection is made by using the daemons legacy port
number.
VNETD only
Connects to the daemons on the server by using only vnetd. If the firewall
rules prevent a server connection using the legacy port number, check this
option.
When selected, the BPCD connect back setting is not applicable.
In addition, the Ports setting uses Non-reserved port, regardless of the value
selected.
Daemon port only
Connects to the daemons on the server by using only the legacy port number.
This option only affects connections to NetBackup 7.0 and earlier. For
connections to NetBackup 7.0.1 and later, the veritas_pbx port is used.
See Resilient Network properties on page 211.

Windows Open File Backup tab of the Client Attributes properties

The Windows Open File Backup properties in the NetBackup Administration
Console specify whether a client uses Windows Open File Backup. The properties
also specify whether Volume Snapshot Provider or Volume Shadow Copy
Service is used as the snapshot provider.

102

Configuring Host Properties

Client Attributes properties

Snapshots are a point-in-time view of a source volume. NetBackup uses snapshots

to access busy or active files during a backup job. Without a snapshot provider,
active files are not accessible for backup.
Figure 3-16

Windows Open File Backup tab of Client Attributes dialog box

The Windows Open File Backup tab contains the following options.

103

Configuring Host Properties

Client Attributes properties

Table 3-18

Windows Open File Backup tab properties

Property

Description

Add

Adds the NetBackup clients only if you want to change the default settings on the Windows
Open File Backup tab.
By default, no clients are listed in the Client Attributes dialog box. The server uses the
following Windows Open File Backup defaults for all Windows clients:

Windows Open File Backup is enabled on the client.

Microsoft Volume Shadow Copy Service (VSS) is used for NetBackup 7.0 clients.
See Back-level and upgraded clients that use Windows Open File Backup on page 107.
Snapshots are taken of individual drives (Individual drive snapshot) as opposed to all
drives at once (Global drive snapshot).
Upon error, the snapshot is terminated (Abort backup on error).

Remove

Deletes a client from the list by selecting the client and then clicking Delete.

Enable Windows Open Specifies that Windows Open File Backups be used for the selected clients. Adds the clients
File Backups
to the list only if you want to change the default property settings.
For Microsoft Distributed File System Replication (DFSR) servers, select Enable Windows
Open File Backups. The Snapshot Provider must be Volume Shadow Copy Service.
See About Microsoft DSFR backups on page 661.
This option functions independently from the Perform Snapshot backups policy option
that is available when the Snapshot Client is licensed.
If a client is included in a policy that has the Perform Snapshot backups policy option
disabled and you do not want snapshots, the Enable Windows Open File Backups for
this client property must be disabled as well for the client. If both options are not disabled,
a snapshot is created, though that may not be the intention of the administrator.
For more information, see the NetBackup Snapshot Client Administrators Guide.

104

Configuring Host Properties

Client Attributes properties

Table 3-18

Windows Open File Backup tab properties (continued)

Property

Description

Snapshot Provider

Selects the snapshot provider for the selected clients:

Use Veritas Volume Snapshot Provider (VSP)

This option specifies that Veritas VSP be used as the snapshot provider. VSP is required
for Windows 2000 clients and can also be used on 6.x Windows 2003 clients.
Use Microsoft Volume Shadow Copy Service (VSS)
This option specifies that Microsoft VSS be used to create volume snapshots of volumes
and logical drives for the selected clients.
In 7.0, Microsoft VSS should be selected for all Windows clients, as VSP is not available.
VSS is available for all supported Windows clients, XP SP2 and later.
Configure VSS through the Microsoft VSS configuration dialog boxes.
For information about how to do Active Directory granular restores when using VSS, see
the following topic:
See Active Directory host properties on page 80.
For Microsoft Distributed File System Replication (DFSR) servers, select Use Microsoft
Volume Shadow Copy Service (VSS).
See About Microsoft DSFR backups on page 661.

105

Configuring Host Properties

Client Attributes properties

Table 3-18

Windows Open File Backup tab properties (continued)

Property

Description

Snapshot usage

Selects how snapshots are made for the selected clients:

Individual drive snapshot

Specifies that the snapshot should be of an individual drive (default). When this property
is enabled, snapshot creation and file backup are done sequentially on a per volume
basis. For example, assume that drives C and D are to be backed up.
If the Individual drive snapshot property is selected, NetBackup takes a snapshot of
drive C, backs it up, and discards the snapshot. It then takes a snapshot of drive D,
backs it up, and discards the snapshot.
Volume snapshots are enabled on only one drive at a time, depending on which drive
is to be backed up. This mode is useful when relationships do not have to be maintained
between files on the different drives.
Use this configuration if snapshot creation fails when all volumes for the backup are
snapshot at once when the Global drive snapshot property is enabled. Individual drive
snapshot is enabled by default for all non-multistreamed backups by using the Windows
Open File Backup option.
Global drive snapshot
Specifies that the snapshot is of a global drive. All the volumes that require snapshots
for the backup job (or stream group for multistreamed backups) are taken at one time.
For example, assume that drives C and D are to be backed up.
In this situation, NetBackup takes a snapshot of C and D. Then NetBackup backs up
Cand backs up D.
NetBackup then discards the C and D snapshots.
This property maintains file consistency between files in different volumes. The backup
uses the same snapshot that is taken at a point in time for all volumes in the backup.

Note: The Individual drive snapshot property and the Global drive snapshot property
only apply to non-multistreamed backups that use Windows Open File Backup. All
multistreamed backup jobs share the same volumes snapshots for the volumes in the
multistreamed policy. The volume snapshots are taken in a global fashion.

106

Configuring Host Properties

Client Attributes properties

Table 3-18
Property

Windows Open File Backup tab properties (continued)

Description

Snapshot error control Selects the processing instructions that NetBackup should follow if it encounters an error
during processing:

Abort backup on error

Specifies that a backup aborts if it fails for a snapshot-related issue after the snapshot
is created and while the backup uses the snapshot to back up open or active files on the
file system.
The most common reason for a problem after the snapshot is created and is in use by
a backup, is that the cache storage is full. If the Abort backup on error property is
checked (default), the backup job aborts with a snapshot error status if the backup detects
a snapshot issue.
This property does not apply to successful snapshot creation. The backup job continues
regardless of whether a snapshot was successfully created for the backup job. The Abort
backup on error property applies only to the snapshot errors that occur after the snapshot
is successfully created and is in use by a backup job.
Disable snapshot and continue
Specifies that if the snapshot becomes invalid during a backup, the volume snapshots
for the backup are destroyed. The backup continues with Windows open file backups
disabled.
Regarding the file that had a problem during a backupit may be that the file was not
backed up by the backup job. The file may not be able to be restored.

Note: Volume snapshots typically become invalid during the course of a backup because
insufficient cache storage was allocated for the volume snapshot. Reconfigure the cache
storage configuration of the Windows Open File Backup snapshot provider to a
configuration that best suits your clients installation.

Back-level and upgraded clients that use Windows Open File Backup
The following table shows the expected Open File Backup behavior based on the
client version and the Snapshot Provider setting.
Table 3-19

Snapshot Provider behavior for clients in a 7.x environment

Client
version

Snapshot Provider
setting

Behavior

6.x

Veritas VSP

Veritas VSP is used for Open File Backup.

(6.5 default setting)

6.x

Veritas VSP

Veritas VSP is used for Open File Backup.

6.x

Windows VSS

Windows VSS is used for Open File Backup.

107

Configuring Host Properties

Client Settings properties for UNIX clients

Snapshot Provider behavior for clients in a 7.x environment

(continued)

Table 3-19

Client
version

Snapshot Provider
setting

Behavior

7.x

Windows VSS

Using VSS for Open File Backup is a new default behavior in 7.x.

(7.0 default setting)

7.x

Veritas VSP

Even if Veritas VSP is indicated, Windows VSS is used for Open File
Backup.
For upgraded clients:

7.x

Windows VSS

For 6.x clients that used VSP and have been upgraded to 7.0:
VSP settings are ignored and VSS snapshots are automatically
implemented.
For 6.x VSS users:
You no longer need to create a Client Attribute entry to enable VSS.
VSS is the only snapshot provider available to the NetBackup 7.0
Windows client.

Windows VSS is used for Open File Backup.

Client Settings properties for UNIX clients

The UNIX Client Settings properties in the NetBackup Administration Console
apply to currently selected NetBackup clients running on the UNIX platform.

108

Configuring Host Properties

Client Settings properties for UNIX clients

Figure 3-17

Client Settings (UNIX) dialog box

The UNIX Client Settings dialog box contains the following properties.
UNIX Client Settings dialog box properties

Table 3-20
Property

Description

Locked file action

Determines what happens when NetBackup tries to back up a file with mandatory
file locking enabled in its file mode.
Select one of the following options:

Wait
By default, NetBackup waits for files to become unlocked. If the wait exceeds
the Client read timeout host property that is configured on the master server,
the backup fails with a status 41.
See Timeouts properties on page 251.
Skip
NetBackup skips the files that currently have mandatory locking set by another
process. A message is logged if it was necessary to skip a file.

109

Configuring Host Properties

Client Settings properties for UNIX clients

Table 3-20

UNIX Client Settings dialog box properties (continued)

Property

Description

Keep status of user-directed

backups, archives, and restores

Specifies the number of days to keep progress reports before the reports are
deleted. The default is three days. The minimum is 0. The maximum is 9,999
days.
Logs for user-directed operations are stored on the client system in the following
directory:
install_path\NetBackup\logs\user_ops\ loginID\logs

Reset file access time

Specifies that the access time (atime) time for a file displays the backup time.
By default, NetBackup preserves the access time by resetting it to the value it
had before the backup.

Note: This setting affects the software and the administration scripts that
examine a files access time.
Megabytes of memory to use for
file compression

Specifies the amount of memory available on the client when files are
compressed during backup. If you select compression, the client software uses
this value to determine how much space to request for the compression tables.
The more memory that is available to compress code, the greater the
compression and the greater the percentage of computer resources that are
used. If other processes also need memory, use a maximum value of half the
actual physical memory on a computer to avoid excessive swapping.
The default is 0. This default is reasonable; change it only if problems are
encountered.

Use VxFS file change log for

incremental backups

Determines if NetBackup uses the File Change Log on VxFS clients.

The default is off.
See VxFS file change log for incremental backups property on page 111.

Default cache device path for

snapshots

For additional information, see the NetBackup Snapshot Client Administrators

Guide.

110

Configuring Host Properties

Client Settings properties for UNIX clients

Table 3-20
Property

UNIX Client Settings dialog box properties (continued)

Description

Do not compress files ending with Corresponds to adding a COMPRESS_SUFFIX =.suffix option to the bp.conf
list
file.
Specifies a list of file extensions. During a backup, NetBackup does not compress
files with these extensions because the file may already be in a compressed
format.
Do not use wildcards to specify these extensions. For example, .A1 is allowed,
but not .A* or .A[1-9]
Files that are already compressed become slightly larger if compressed again.
If compressed files with a unique file extension already exist on a UNIX client,
exclude it from compression by adding it to this list.
Add

Adds file endings to the list of file endings that you do not want to compress.
Click Add, then type the file extension in the File Endings dialog box. Use
commas or spaces to separate file endings if more than one is added. Click
Add to add the ending to the list, then click Close to close the dialog box.

Add to All

Adds a file extension that you do not want to compress, to the lists of all clients.
To add the file extension to the lists of all clients, select it in the list on the Client
Settings host property, then click Add to All.

Remove

Removes a file extension from the list. To remove a name, either type it in the
box or click the browse button (...) and select a file ending. Use commas or
spaces to separate names.

VxFS file change log for incremental backups property

The Use VxFS file change log for incremental backups property is supported
on all platforms and versions where VxFS file systems support FCL.
The following VxFS file systems support FCL:

Solaris SPARC platform running VxFS 4.1 or later.

AIX running VxFS 5.0 or later.

HP 11.23 running VxFS 5.0 or later.

Linux running VxFS 4.1 or later.

The File Change Log (FCL) tracks changes to files and directories in a file system.
Changes can include files created, links and unlinks, files renamed, data that is
appended, data that is overwritten, data that is truncated, extended attribute
modifications, holes punched, and file property updates.

111

Configuring Host Properties

Client Settings properties for UNIX clients

NetBackup can use the FCL to determine which files to select for incremental
backups, which can potentially save unnecessary file system processing time. The
FCL information that is stored on each client includes the backup type, the FCL
offset, and the timestamp for each backup.
The advantages of this property depend largely on the number of file system changes
relative to the file system size. The performance impact of incremental backups
ranges from many times faster or slower, depending on file system size and use
patterns.
For example, enable this property for a client on a very large file system that
experiences relatively few changes. The incremental backups for the client may
complete sooner since the policy needs to read only the FCL to determine what
needs to be backed up on the client.
If a file experiences many changes or multiple changes to many files, the time
saving benefit may not be as great.
See Backup Selections tab on page 786.
The following items must be in place for the Use VxFS file change log for
incremental backups property to work:

Enable the Use VxFS file change log for incremental backups property for
every client that wants NetBackup to take advantage of the FCL.

Enable the FCL on the VxFS client.

See the Veritas File System Administrators Guide for information about how to
enable the FCL on the VxFS client.

Enable the Use VxFS file change log for incremental backups property on
the client(s) in time for the first full backup. Subsequent incremental backups
need this full backup to stay synchronized.

Specify the VxFS mount point in the policy backup selections list in one of the
following ways:

Specify ALL_LOCAL_DRIVES.

Specifying the actual VxFS mount point.

Specifying a directory at a higher level than the VxFS mount point, provided
that Cross mount points is enabled.
See Cross mount points (policy attribute) on page 690.

If the policy has Collect true image restore information or Collect true image
restore information with move detection enabled, it ignores the Use VxFS file
change log for incremental backups property on the client.
The following table describes the additional options that are available on the VxFS
file change log feature.

112

Configuring Host Properties

Client Settings properties for Windows clients

Table 3-21

113

VxFS file change log feature options

Option

Description

Activity Monitor messages

Displays any messages that note when the file change log
is used during a backup as follows:
Using VxFS File Change Log for backup of pathname
Also notes when full and incremental backups are not
synchronized.

Keeping the data files

synchronized with the FCL

The data files must be in sync with the FCL for this property
to work. To keep the data files synchronized with the FCL,
do not turn the FCL on the VxFS client off and on.

Note: If NetBackup encounters any errors as it processes

the FCL, it switches to the normal files system scan. If this
switch occurs, it appears in the Activity Monitor.
VxFS administration

Additional VxFS commands are available to administrate the

FCL in the Veritas File System Administrators Guide.

Client Settings properties for Windows clients

The Windows Client Settings properties apply to currently selected Windows
clients.

Configuring Host Properties

Client Settings properties for Windows clients

Figure 3-18

Windows Client Settings dialog box

The Client Settings dialog box for Windows clients contains the following properties.
Table 3-22

Windows Client Settings properties

Property

Description

General level

Enables logs for bpinetd, bpbkar, tar, and nbwin. The higher the level, the
more information is written. The default is 0.

TCP level

Enables logs for TCP.

Scroll to one of the following available log levels:

0 No extra logging (default)

1 Log basic TCP/IP functions

2 Log all TCP/IP functions, including all read and write requests

3 Log contents of each read or write buffer

Note: Setting the TCP level to 2 or 3 can cause the status reports to be very
large. It can also slow a backup or restore operation.

114

Configuring Host Properties

Client Settings properties for Windows clients

Table 3-22
Property

Windows Client Settings properties (continued)

Description

Wait time before clearing archive Specifies how long the client waits before the archive bits for a differential
bit
incremental backup are cleared. The minimum allowable value is 300 (default).
The client waits for acknowledgment from the server that the backup was
successful. If the server does not reply within this time period, the archive bits are
not cleared.
This option applies only to differential-incremental backups. Cumulative-incremental
backups do not clear the archive bit.
Use change journal

Note: The Use Change Journal option applies to Windows clients only.
This option works together with the Use Accelerator policy attribute and the
Accelerator forced rescan schedule attribute.
See Accelerator and the Windows change journal on page 710.
See Use Accelerator (policy attribute) on page 707.
See Accelerator forced rescan option (schedule attribute) on page 742.

Incrementals based on
timestamp

Specifies that files are selected for the backups that are based on the date that
the file was last modified. When Use change journal is selected, Incrementals
based on timestamp is automatically selected.

Incrementals based on archive

bit

Specifies that NetBackup include files in an incremental backup only if the archive
bit of the file is set. The system sets this bit whenever a file is changed and it
normally remains set until NetBackup clears it.
A full backup always clears the archive bit. A differential-incremental backup clears
the archive bit if the file is successfully backed up. The differential-incremental
backup must occur within the number of seconds that the Wait time before
clearing archive bit property indicates. A cumulative-incremental or user backup
has no effect on the archive bit.
Disable this property to include a file in an incremental backup only if the date
and time stamp for the file has changed since the last backup. For a
differential-incremental backup, NetBackup compares the date/time stamp to the
last full or incremental backup. For a cumulative-incremental backup, NetBackup
compares the timestamp to the last full backup.
If you install or copy files from another computer, the new files retain the date
timestamp of the originals. If the original date is before the last backup date on
this computer, then the new files are not backed up until the next full backup.

Note: Symantec recommends that you do not combine differential incremental

backups and cumulative incremental backups within the same Windows policy
when the incremental backups are based on archive bit.

115

Configuring Host Properties

Client Settings properties for Windows clients

Table 3-22

Windows Client Settings properties (continued)

Property

Description

Time overlap

Specifies the number of minutes to add to the date range for incremental backups
when you use date-based backups. This value compensates for differences in
the speed of the clock between the NetBackup client and server. The default is
60 minutes.
This value is used during incremental backups when you use the archive bit and
when you examine the create time on folders. This comparison is done for archive
bit-based backups as well as date-based backups.

Communications buffer size

Specifies the size (in kilobytes) of the TCP and the IP buffers that NetBackup
uses to transfer data between the NetBackup server and client. For example,
specify 10 for a buffer size of 10 kilobytes. The minimum allowable value is 2,
with no maximum allowable value. The default is 128 kilobytes.

User directed timeouts

Specifies the seconds that are allowed between when a user requests a backup
or restore and when the operation begins. The operation fails if it does not begin
within this time period.
This property has no minimum value or maximum value. The default is 60 seconds.

Maximum error messages for

server

Defines how many times a NetBackup client can send the same error message
to a NetBackup server. For example, if the archive bits cannot be reset on a file,
this property limits how many times the message appears in the server logs. The
default is 10.

Keep status of user-directed

Specifies how many days the system keeps progress reports before NetBackup
backups, archives, and restores automatically deletes them. The default is 3 days.
Perform default search for
restore

Instructs NetBackup to search the default range of backup images automatically.

The backed up folders and files within the range appear whenever a restore
window is opened.
Clear the Perform default search for restore check box to disable the initial
search. With the property disabled, the NetBackup Restore window does not
display any files or folders upon opening. The default is that the option is enabled.

How to determine if change journal support is useful in your

NetBackup environment
Using NetBackup support for the change journal is beneficial only where the volumes
are large and relatively static.
Suitable candidates for enabling NetBackup change journal support are as follows:

If the NTFS volume contains more than 1,000,000 files and folders and the
number of changed objects between incremental backups is small (less than

116

Configuring Host Properties

Client Settings properties for Windows clients

100,000), the volume is a good candidate for enabling NetBackup change journal
support.
Unsuitable candidates for enabling NetBackup change journal support are as follows:

Support for the change journal is intended to reduce scan times for incremental
backups by using the information that is gathered from the change journal on a
volume. Therefore, to enable NetBackup change journal support is not
recommended if the file system on the volume contains relatively few files and
folders. (For example, hundreds of thousands of files and folders.) The normal
file system scan is suitable under such conditions.

If the total number of changes on a volume exceeds from 10% to 20% of the
total objects, the volume is not a good candidate for enabling NetBackup change
journal support.

Be aware that virus scanning software can interfere with the use of the change
journal. Some real-time virus scanners intercept a file open for read, scan for
viruses, then reset the access time. This results in the creation of a change
journal entry for every scanned file.

Guidelines for enabling NetBackup change journal support

The following items are guidelines to consider for enabling NetBackup change
journal support:

Change journal support is not offered for user-directed backups. The USN
stamps for full and incremental backups in the permanent record do not change.

NetBackup support for change journal works with checkpoint restart for restores.
See Checkpoint restart for restore jobs on page 682.

Support for change journal is not offered with several NetBackup options or
Symantec products.
If Use change journal is enabled, it has no effect while you use the following
options or products:

True image restore (TIR) or True image restore with Move Detection
See Collect true image restore information (policy attribute) with and without
move detection on page 698.

Synthetic backups
See About synthetic backups on page 843.

Bare Metal Restore (BMR)

For more information, see the NetBackup Bare Metal Restore Administrators
Guide.

117

Configuring Host Properties

Credential Access properties

See How to determine if change journal support is useful in your NetBackup

environment on page 116.

Credential Access properties

Certain NetBackup hosts that are not named as clients in a policy must be enabled
to access NDMP or disk array credentials. Use the Credential Access properties
dialog box to enter the names of those NetBackup hosts.
Figure 3-19

Credential Access dialog box

The Credential Access dialog box contains the following properties.

Table 3-23

Credential Access dialog box properties

Property

Description

NDMP Clients list

To add an NDMP client to the NDMP Clients list, click Add. Enter the names of the
NDMP hosts that are not named as clients in a policy.

118

Configuring Host Properties

Data Classification properties

Table 3-23

Credential Access dialog box properties (continued)

Property

Description

Disk clients list

To add a Disk Client to the DISK Clients list, click Add. Enter the names of the
NetBackup hosts that meet all of the following criteria:

The host must be designated in a policy as the Off-host backup host in an alternate
client backup.
The host that is designated as the Off-host backup computer must not be named
as a client on the Clients tab in any NetBackup policy.
The policy for the off-host backup must be configured to use one of the disk array
snapshot methods for the EMC CLARiiON, HP EVA, or IBM disk arrays

Note: The credentials for the disk array or NDMP host are specified under Media
and Device Management > Credentials.

Note: Off-host alternate client backup is a feature of NetBackup Snapshot Client,

which requires a separate license. The NetBackup for NDMP feature requires the
NetBackup for NDMP license.

Data Classification properties

The Data Classification properties apply to currently selected master and media
servers.
Data classifications must be configured in the Data Classification host properties
before storage lifecycle policies can be configured.
See Data classifications (policy attribute) on page 675.

119

Configuring Host Properties

Data Classification properties

Figure 3-20

Data Classification dialog box

The Data Classification dialog box contains the following properties.

Table 3-24

Data Classification dialog box properties

Property

Description

Rank column

The Rank column displays the rank of the data classifications. The order of the data
classifications determines the rank of the classification in relationship to the others in
the list. The lowest numbered rank has the highest priority.
Use the Move Up and Move Down options to move the classification up or down in
the list.
To create a new data classification, click New. New data classifications are added to
bottom of the list. To increase the rank of a data classification, select a line and click
Move Up. To decrease the rank of a data classification, select a line and click Move
Down.

120

Configuring Host Properties

Data Classification properties

Table 3-24

Data Classification dialog box properties (continued)

Property

Description

Name column

The Name column displays the data classification name. While data classifications
cannot be deleted, the data classification names can be modified.
NetBackup provides the following data classifications by default:

Platinum (highest rank by default)

Gold (second highest rank by default)

Silver (third highest rank by default)

Bronze (lowest rank by default)

Description column

In the Description column, enter a meaningful description for the data classification.
Descriptions can be modified.

Data Classification ID

The Data Classification ID is the GUID value that identifies the data classification and
is generated when a new data classification is added and the host property is saved.
This column is not displayed by default.
A data classification ID becomes associated with a backup image by setting the Data
Classification attribute in the policy dialog box. The ID is written into the image header.
The storage lifecycle policies use the ID to identify the images that are associated with
classification.
ID values can exist in image headers indefinitely, so data classifications cannot be
deleted. The name, description, and rank can change without changing the identity of
the data classification.

Note: Data classifications cannot be deleted. However, the name, description, and
the rank can be changed. The classification ID remains the same.

Creating a Data Classification

Use the following procedures to create or change a data classification.
To create a data classification

In the NetBackup Administration Console, in the left pane, expand

NetBackup Management > Host Properties.

In the left pane, click Data Classification.

Click New.

Add the name and description in the New Data Classification dialog box.

121

Configuring Host Properties

Default Job Priorities properties

Click OK to save the classification and close the dialog box.

Note: Data classifications cannot be deleted.

Select a line in the Data Classification host properties and use the Move Up
and Move Down options to move the classification level up or down in the list.

Default Job Priorities properties

The Default Job Priorities host properties let administrators configure the default
job priority for different job types. The Default Job Priorities host properties list
18 job types and the configurable default priority for each.
Figure 3-21

Default Job Priorities dialog box

The job priority can be set for individual jobs in the following utilities:

In the Jobs tab of the Activity Monitor for queued or active jobs.
See Changing the Job Priority dynamically from the Activity Monitor on page 1025.

122

Configuring Host Properties

Default Job Priorities properties

In the Catalog utility for verify, duplicate, and import jobs.

In the Reports utility for a Media Contents report job.

In the Backup, Archive, and Restore client interface for restore jobs.

The Default Job Priorities dialog box contains the following properties.
Table 3-25
Property

Default Job Priorities dialog box properties

Description

Job Type and Job Priority list This listing includes 18 job types and the current configurable priority for each.
Job Priority

The Job Priority value specifies the priority that a job has as it competes with other
jobs for backup resources. The value can range from 0 to 99999. The higher the number,
the greater the priority of the job.
A new priority setting affects all the policies that are created after the host property has
been changed.
A higher priority does not guarantee that a job receives resources before a job with a
lower priority. NetBackup evaluates jobs with a higher priority before those with a lower
priority.
However, the following factors can cause a job with a lower priority to run before a job
with a higher priority:

To maximize drive use, a low priority job may run first if it can use a drive that is
currently loaded. A job with a higher priority that requires that the drive be unloaded
would wait.
If a low priority job can join a multiplexed group, it may run first. The job with a
higher priority may wait if it is not able to join the multiplexed group.
If the NetBackup Resource Broker (nbrb) receives a job request during an
evaluation cycle, it does not consider the job until the next cycle, regardless of the
job priority.

Understanding the Job Priority setting

NetBackup uses the Job Priority setting as a guide. Requests with a higher priority
do not always receive resources before a request with a lower priority.
The NetBackup Resource Broker (NBRB) maintains resource requests for jobs in
a queue.
NBRB evaluates the requests sequentially and sorts them based on the following
criteria:

The request's first priority.

The requests second priority.

123

Configuring Host Properties

Default Job Priorities properties

The birth time (when the Resource Broker receives the request).

The first priority is weighted more heavily than the second priority, and the second
priority is weighted more heavily than the birth time.
Because a request with a higher priority is listed in the queue before a request with
a lower priority, the request with a higher priority is evaluated first. Even though the
chances are greater that the higher priority request receives resources first, it is
not always definite.
The following scenarios present situations in which a request with a lower priority
may receive resources before a request with a higher priority:

A higher priority job needs to unload the media in a drive because the retention
level (or the media pool) of the loaded media is not what the job requires. A
lower priority job can use the media that is already loaded in the drive. To
maximize drive utilization, the Resource Broker gives the loaded media and
drive pair to the job with the lower priority.

A higher priority job is not eligible to join an existing multiplexing group but a
lower priority job is eligible to join the multiplexing group. To continue spinning
the drive at the maximum rate, the lower priority job joins the multiplexing group
and runs.

The Resource Broker receives resource requests for jobs and places the requests
in a queue before processing them. New resource requests are sorted and
evaluated every 5 minutes. Some external events (a new resource request or
a resource release, for example) can also trigger an evaluation. If the Resource
Broker receives a request of any priority while it processes requests in an
evaluation cycle, the request is not evaluated until the next evaluation cycle
starts.

124

Configuring Host Properties

Distributed application restore mapping properties

Distributed application restore mapping properties

Figure 3-22

Distributed Application Restore Mapping dialog box

Some applications, such as SharePoint and Exchange, distribute and replicate data
across multiple hosts. You need to provide a mapping of the hosts in the database
environment so thatNetBackup can successfully restore the databases.
The Distributed Application Restore Mapping dialog box contains the following
properties.

125

Configuring Host Properties

Encryption properties

Table 3-26

Distributed Application Restore Mapping dialog box properties

Property

Description

Add

Adds a component host that is authorized to run restores on an SharePoint or Exchange

application host.
For SharePoint, NetBackup catalogs backup images under the front-end server name.
To allowNetBackup to restore SQL databases to the correct hosts in a farm, you must
provide a list of the SharePoint hosts. For Exchange, any operations that use Granular
Recovery Technology (GRT) require that you provide a list of the Exchange virtual and
the physical host names. Also include the CAS server, the off-host client, and the
granular proxy host.

Note: For VMware backups and restores that protect SharePoint or Exchange, you
only need to add the hosts that browse for backups or perform restores.

Note: You can use the client's short name or its fully qualified domain name (FQDN).
You do not need to provide both names in the list.
For more details, see the following:
NetBackup for Microsoft SharePoint Server Administrator's Guide.
NetBackup for Microsoft Exchange Server Administrator's Guide.
Change

Changes the application host or component host of the currently selected mapping.

Remove

Removes the currently selected mapping.

Encryption properties
The Encryption properties control encryption on the currently selected client.
Multiple clients can be selected and configured at one time only if all selected clients
are running the same version of NetBackup. If not, the Encryption properties dialog
box is hidden.
More information is available in the NetBackup Security and Encryption Guide.

126

Configuring Host Properties

Encryption properties

Figure 3-23

Encryption dialog box

The Encryption permissions property indicates the encryption setting on the

selected NetBackup client as determined by the master server.
Table 3-27

Encryption permissions selections

Property

Description

Not allowed

Specifies that the client does not permit encrypted backups.

If the server requests an encrypted backup, the backup job
ends due to error.

Allowed

Specifies that the client allows either encrypted or

unencrypted backups. Allowed is the default setting for a
client that has not been configured for encryption.

Required

Specifies that the client requires encrypted backups. If the

server requests an unencrypted backup, the backup job ends
due to error.

127

Configuring Host Properties

Encryption properties

Select the Enable encryption property if the NetBackup Encryption option is used
on the selected client.
After Enable Encryption is selected, choose from the properties in Table 3-28.
Table 3-28

Encryption dialog box properties

Property

Description

Enable standard
encryption

Pertains to the 128-bit and the 256-bit options of NetBackup Encryption.

Client Cipher

The following cipher types are available: BF-CFB, DES-EDE-CFB, AES-256-CFB, and
AES-128-CFB. AES-128-CFB is the default.

If the selected client does not use Legacy encryption, Enable standard encryption is
automatically selected.

More information on the ciphers file is found in the NetBackup Security and Encryption Guide.
Enable legacy
DES encryption

Pertains to the 40-bit and the 56-bit data encryption standard (DES) NetBackup encryption
packages.

Encryption
strength

Defines the encryption strength on the NetBackup client when Legacy encryption is used:

Encryption
libraries

DES_40
Specifies the 40-bit DES encryption. DES_40 is the default value for a client that has not been
configured for encryption.
DES_56
Specifies the 56-bit DES encryption.

Specify the folder that contains the encryption libraries on NetBackup clients.
The default location is as follows:

On Windows:
install_path\netbackup\bin\
Where install_path is the directory where NetBackup is installed and by default is C:\Program
Files\VERITAS.

On UNIX:
/usr/openv/lib

If it is necessary to change the setting, specify the new name.

128

Configuring Host Properties

Encryption properties

Table 3-28

Encryption dialog box properties (continued)

Property

Description

Encryption key
file

Specify the file that contains the encryption keys on NetBackup clients.
The default location is as follows:

On Windows:
install_path\NetBackup\bin\keyfile.dat
Where install_path is the folder where NetBackup is installed and by default is C:\Program
Files\VERITAS.

On UNIX:
/usr/openv/netbackup/keyfile

If it is necessary to change the setting, specify the new name.

Additional encryption methods for Windows clients

In addition to NetBackup client and server data encryption, Microsoft Windows
clients also have access to methods of encrypting the data on the original disk.
Each of the following methods has its own costs and benefits. NetBackup supports
each method for protecting Microsoft Windows clients.

Encrypting File System

The Encrypting File System (EFS) on Microsoft Windows is a feature introduced
with Windows 2000 and provides file system-level encryption. EFS is a form of
encryption where individual files or directories are encrypted by the file system itself.
The technology enables files to be transparently encrypted to protect confidential
data from attackers with physical access to the computer. Users can enable
encryption on a per-file, per-directory, or per-drive basis. The Group Policy in a
Windows domain environment can also mandate some EFS settings.
No NetBackup settings are involved in protecting these encrypted objects. Any
object with an encrypted file system attribute is automatically backed up and restored
in its encrypted state.

BitLocker Drive Encryption

BitLocker Drive Encryption is a full disk encryption feature included with certain
editions of Microsoft's Windows desktop and server versions, starting with Vista
and Windows Server 2008.

129

Configuring Host Properties

Enterprise Vault properties

Disk encryption is a technology which protects information by converting it into

unreadable code that cannot be deciphered easily by unauthorized people. Disk
encryption uses disk encryption software or hardware to encrypt every bit of data
that goes on a disk or a disk volume.
As with EFS, no NetBackup settings are involved to use BitLocker for encryption.
Unlike EFS, the encryption layer is invisible to NetBackup, with the data being
automatically decrypted and encrypted by the operating system.
NetBackup does nothing to manage the encryption process and therefore backs
up and restores the unencrypted data.
Note: If you recover a Windows computer that has BitLocker encryption enabled,
you must re-enable BitLocker encryption following the restore.
Off-host backup is not supported with volumes that run Windows BitLocker Drive
Encryption.

Enterprise Vault properties

The Enterprise Vault properties apply to currently selected clients.
To perform backups and restores, NetBackup must know the user name and
password for the account that is used to log on to the Enterprise Vault Server and
to interact with the Enterprise Vault SQL database. The user must set the logon
account for every NetBackup client that runs backup and restore operations for
Enterprise Vault components.

130

Configuring Host Properties

Enterprise Vault Hosts properties

Figure 3-24

Enterprise Vault dialog box

The Enterprise Vault dialog box contains the following properties.

Table 3-29

Enterprise Vault dialog box properties

Property

Description

User Name

Specify the user ID for the account that is used to log on to Enterprise Vault
(DOMAIN\user name).

Password

Specify the password for the account.

Consistency check before

backup

Select what kind of consistency checks to perform on the SQL Server databases
before NetBackup begins a backup operation.

Enterprise Vault Hosts properties

The Enterprise Vault Hosts properties apply to currently selected master servers.
Special configuration is required to allow NetBackup to restore SQL databases to
the correct hosts in an Enterprise Vault farm. In the Enterprise Vault Hosts master

131

Configuring Host Properties

Exchange properties

server properties, specify a source and a destination host. By doing so, you specify
a source host that can run restores on the destination host.
Figure 3-25

Enterprise Vault Hosts master server properties

The Enterprise Vault Hosts dialog box contains the following properties.
Table 3-30

Enterprise Vault Hosts dialog box properties

Option

Description

Add

Adds the source and the destination hosts within the Enterprise Vault configuration.
You must provide the name of the Source host and the name of the Destination host.

Change

Changes the source host and the destination host, an entry that you select from the
Enterprise Vault Hosts field.

Exchange properties
The Exchange properties apply to the currently selected Windows clients. For
clustered or replicated environments, configure the same settings for all nodes. If

132

Configuring Host Properties

Exchange properties

you change the attributes for the virtual server name, only the CCR active node or
DAG host server is updated.
Figure 3-26

Exchange dialog box

The Exchange dialog box contains the following properties.

Table 3-31

Exchange dialog box properties

Property

Description

Snapshot verification I/O throttle

Note: This property only applies to MS-Exchange-Server backup policies with

Exchange 2007.
This option applies to off-host Exchange 2007 snapshot backups if the Exchange
System Management Tools are not installed on the alternate client. Specify the
number of I/Os to process for each 1-second pause.

133

Configuring Host Properties

Exchange properties

Table 3-31

Exchange dialog box properties (continued)

Property

Description

Backup option for log files

during full backups

Note: This property only applies to MS-Exchange-Server backup policies.

Choose which logs to include with snapshot backups:

Truncate log after successful

Instant Recovery backup

Back up only uncommitted log files

Select this option to back up only the log files that are uncommitted. This option
is not recommended for DAGs or Exchange 2007 CCR environments.
Back up all log files (including committed log files)

Note: This property only applies to MS-Exchange-Server backup policies.

Enable this option to delete transaction logs after a successful Instant Recovery
backup. By default, transaction logs are not deleted for a full Instant Recovery
backup that is snapshot only.

Exchange granular proxy host

Note: This property applies when you duplicate or browse a backup that uses
Granular Recovery Technology (GRT).
You can specify a different Windows system to act as a proxy for the source client
when you duplicate or browse a backup (with bplist) that uses GRT. Use a
proxy if you do not want to affect the source client or if it is not available.

Enable single instance backup

for message attachments

Note: This property only applies to MS-Exchange-Server backup policies with

Exchange 2007.
Enable this option to back up the data that is stored on a Single Instance Store
(SIS) volume. This feature only applies to mailbox and public folder backups with
Exchange Server 2007.

Perform consistency check

before backup with Microsoft
Volume Shadow Copy Service
(VSS)

Note: This property only applies to MS-Exchange-Server backup policies.

Disable this option if you do not want to perform a consistency check during a
DAG backup. If you check Continue with backup if consistency check fails,
NetBackup continues to perform the backup even if the consistency check fails.

134

Configuring Host Properties

Exchange properties

Table 3-31

Exchange dialog box properties (continued)

Property

Description

Exchange credentials

Note the following for this property:

This property applies to MS-Exchange-Server and VMware backup policies

with Exchange recovery.
This property does not apply to any backup and restore operations that have
a policy that uses the Microsoft Exchange Mailboxes:\ and the
Microsoft Exchange Public Folders:\ directives. Instead, you must
configure the logon account for the NetBackup Client Service with the
credentials for the account for NetBackup Exchange operations.

Provide the credentials for the account for NetBackup Exchange operations. This
account must have the necessary permissions to perform Exchange restores.
The permissions that are required depend on the Exchange version that you have.
The account also needs the right to Replace a process level token.
Configure Exchange 2013 as follows:

If you added Exchange Servers to the View-Only Organization Management

role group, configure the Exchange credentials only on the granular clients
that perform restores.
Otherwise, configure the Exchange credentials on all granular clients.

Previous NetBackup users can continue to configure the NetBackup Client Service
and the NetBackup Legacy Network Service (Exchange 2010). Several additional
conditions apply:

For Exchange 2013, you must configure the Exchange credentials if you want
to use GRT.
If you use Replication Director to manage your VMware snapshots and
snapshot replication, you must configure the Exchange credentials in the host
properties. The NetBackup Client service must log on with an account that
has access to the CIFS share on the NetApp disk array.
(Exchange 2010 or 2007) If you configure the NetBackup Client Service with
a logon account and configure the Exchange credentials in the Exchange
client host properties, you must configure the Replace a process level token
for both users.

About the Exchange credentials in the client host properties

The Exchange credentials in the client host properties indicate the account that has
necessary permissions to perform Exchange restores. The permissions that are
required depend on the Exchange version that you have.
Note the following:

135

Configuring Host Properties

Exclude Lists properties

The account that you configured for the Exchange credentials must also have
the right to Replace a process level token.

For database restores from VMware backups, the Exchange credentials that
you provide must have permissions to restore VM files. For granular restores
from VMware backups, only the Exhange client that performs the granular restore
require configuration of the Exchange credentials. The Exchange credentials
are not required for backup or browse operations.

If you want to restore from a VMware snapshot copy that was created with
Replication Director, do the following:

Provide the Exchange credentials in the Domain\user and Password fields.

Configure the NetBackup Client Service with an account that has access to
the CIFS shares that are created on the NetApp disk array.

Additional notes for Exchange 2010 and 2007

These additional items apply to Exchange 2010 and 2007:

If you configure the NetBackup Client Service with a logon account and configure
the Exchange credentials in the Exchange client host properties, you must
configure the Replace a process level token for both users.

In NetBackup 7.5 and earlier, you added the credentials to the logon account
for the NetBackup Client Service and the NetBackup Legacy Network Service
(Exchange 2010). Customers upgrading from earlier versions of NetBackup can
continue to use this configuration (unless you use Replication Director). Symantec
recommends that you use the new configuration in the Exchange client host
properties.

(Exchange 2007) If you use the Microsoft Exchange Mailboxes:\ and the
Microsoft Exchange Public Folders:\ directives in a policy, you must use
the old configuration. Configure the NetBackup Client Service to log on as the
account for NetBackup Exchange operations.

Exclude Lists properties

Use the Exclude Lists host properties to create and to modify the exclude lists for
Windows clients. An exclude list names the files and directories to be excluded
from backups of the selected Windows clients.
For UNIX clients, use the nbgetconfig and nbsetconfig commands to gather and
modify the exclude list files from the /usr/openv/netbackup directory on each
client. nbgetconfig and nbsetconfig can also be used on a UNIX server to create
an exclude list on a Windows client.

136

Configuring Host Properties

Exclude Lists properties

See Configuring the exclude list on a Windows client from a UNIX master server
on page 144.
Figure 3-27

Exclude Lists dialog box

Exclude Lists properties apply only to Windows clients.

For information about creating exclude lists for UNIX clients, see the following topic:
See About excluding files from automatic backups on page 824.
If more than one exclude or include list exists for a client, NetBackup uses only the
most specific one.
For example, assume that a client has the following exclude lists:

An exclude list for a policy and schedule.

An exclude list for a policy.

An exclude list for the entire client. This list does not specify a policy or schedule.

In this example, NetBackup uses the first exclude list (for policy and schedule)
because it is the most specific.

137

Configuring Host Properties

Exclude Lists properties

Exclude and include lists that are set up for a policy or for a policy and schedule
are not used to determine if an entire drive is to be excluded when NetBackup
determines if a backup job should be started.
Normally, this is not a problem. However, if a policy uses multistreaming and a drive
or a mount point is excluded, that job will report an error status when it completes.
To avoid the situation, do not use the policy or the policy and schedule lists to
exclude an entire volume.
The Exclude Lists dialog box contains the following properties.
Table 3-32
Property

Excludes Lists dialog box properties

Description

Use case sensitive exclude Indicates that the files and directories to exclude are case-sensitive.
list
Exclude lists

Displays the policies that contain schedule, file, and directory exclusions as follows:

Add
Click to exclude a file from being backed up by a policy. The exclusion is configured
in the Add to exclude list dialog box, then added to the Exclude list. When the
policies in this list are run, the files and directories that are specified on the list are
not backed up.
Add to all
When multiple Windows clients are selected, click Add to all to add the selected
list item to the Exclude list for all selected clients. Add to all is enabled only when
multiple Windows clients are selected for configuration.
Remove
Click to remove the selected policy, schedule, or file from the Exclude list.

138

Configuring Host Properties

Exclude Lists properties

Table 3-32

Excludes Lists dialog box properties (continued)

Property

Description

Exceptions to exclude list

Displays the policies, schedules, files, and directories that are excepted from the
Exclude list. When the policies on the Exceptions to the exclude list run, the files
and directories on the list are backed up if they were part of the original file list and
were subsequently excluded. The list is useful to exclude all files in a directory but one.
For example, if the file list of items to back up contains /foo, and the exclude list
contains /foo/bar, adding /fum to the exceptions list does not back up the /fum
directory. However, adding fum to the exceptions list will back up any occurrences of
fum (file or directory) that occur within /foo/bar.
Options include the following:

Add
Click to create an exception to the Exclude list. The exception is configured in the
Add exceptions to exclude list dialog box, then added to the Exceptions to the
exclude list.
When the policies on the Exceptions to the exclude list run, the items on the
exceptions list are backed up (if they were part of the original file list and
subsequently excluded). Effectively, you add files back into the backup list of a
policy.
Add to all
When multiple Windows clients are selected, click Add to all to add the selected
list item to the Exceptions to the exclude list for all selected clients. When the
policies on the exclude list run, the items on the exceptions list are backed up on
all selected clients.
Remove
Click to remove the selected policy, schedule, or file from the Exceptions list. After
the item is removed from the Exclude list, the item is excluded from the backup.

About the Add to exclude list and Add to exceptions list dialog boxes
The Add to Exclude List dialog box and the Add Exceptions to Exclude List
dialog box contain the following fields:
Table 3-33

Add to Exclude dialog box

Field

Description

Policy

The policy name that contains the files and the directories
that you want to exclude or make exceptions for. You can
also select the policy name from the drop-down menu. To
exclude or make exceptions for the backup of specific files
or directories from all policies, select <All Policies>.

139

Configuring Host Properties

Exclude Lists properties

Table 3-33

Add to Exclude dialog box (continued)

Field

Description

Schedule

The schedule name that is associated with the files and the
directories that you want to exclude or make exceptions for.
You can also select the schedule name from the drop-down
menu. To exclude or make exceptions for the backups of
specific files or directories from all schedules, select <All
Schedules>.

Files/Directories

The full path to the file(s) and the directories that you want
to exclude or make exceptions for.

Figure 3-28

Add to Exclude List properties

Adding an entry to an exclude list

Use the following procedure to add an entry to an exclude list for a policy:
To add an entry to the exclude list

In the NetBackup Administration Console, expand NetBackup Management

> Host Properties > Clients. Double-click on a client.

Under the Exclude List, click Add.

In the Policy field, select a policy name from the drop-down menu or enter the
name of a policy. Select All Policies to exclude these items from all policies.

In the Schedule field, select a schedule name from the drop-down menu or
enter the name of a schedule. Select All Schedules to exclude the specified
files and directories from all schedules in the policy.

In the Files/Directories field, enter the files or directories to be excluded from

the backups that are based on the selected policy and schedule.

140

Configuring Host Properties

Exclude Lists properties

Click Add to add the specified files and directories to the exclude list.

Click Apply to accept the changes. Click OK to accept the changes and close
the host properties dialog box.

Adding an exception to the exclude list

Use the following procedure to add an exception to the exclude list for a policy:
To add an exception to the exclude list

In the NetBackup Administration Console, expand NetBackup Management

> Host Properties > Clients. Double-click on a client.

Under the Exceptions to the Exclude List, click Add.

In the Policy field, select a policy name from the drop-down menu or enter the
name of a policy. Select All Policies to add these items back into all policies.
(In other words, these items are to be excluded from the exclude list.)

In the Schedule field, select a schedule name from the drop-down menu or
enter the name of a schedule. Select All Schedules to add these items back
into the schedules.

In the Files/Directories field, enter the files or directories to be added back

into the backups that are based on the selected policy and schedule.

Click Add to add the specified files and directories to the Exceptions to the
Exclude List.

Click Apply to accept the changes. Click OK to accept the changes and close
the host properties dialog box.

Syntax rules for exclude lists

Symantec suggests that you always specify automounted directories and CD-ROM
file systems in the exclude list. Otherwise, if the directories are not mounted at the
time of a backup, NetBackup must wait for a timeout.
The following syntax rules apply to exclude lists:

Only one pattern per line is allowed.

NetBackup recognizes standard wildcard use.

See Wildcard use in NetBackup on page 1108.
See NetBackup naming conventions on page 1107.

If all files are excluded in the backup selections list, NetBackup backs up only
what is specified by full path names in the include list. Files can be excluded by
using / or * or by using both symbols together (/*).

141

Configuring Host Properties

Exclude Lists properties

Spaces are considered legal characters. Do not include extra spaces unless
they are part of the file name.
For example, if you want to exclude a file named
C:\testfile (with no extra space character at the end)
and your exclude list entry is
C:\testfile (with an extra space character at the end)
NetBackup cannot find the file until you delete the extra space from the end of
the file name.

End a file path with \ to exclude only directories with that path name (for example,
C:\users\test\). If the pattern does not end in \ (for example, C:\users\test),
NetBackup excludes both files and directories with that path name.

To exclude all files with a given name, regardless of their directory path, enter
the name. For example:
test

rather than
C:\test

This example is equivalent to prefixing the file pattern with

\
\*\
\*\*\
\*\*\*\

and so on.
The following syntax rules apply only to UNIX clients:

Do not use patterns with links in the names. For example, assume /home is a
link to /usr/home and /home/doc is in the exclude list. The file is still backed
up in this case because the actual directory path, /usr/home/doc, does not
match the exclude list entry, /home/doc.

Blank lines or lines which begin with a pound sign (#) are ignored.

Example of a Windows client exclude list

Assume that an exclude list in the Exclude Lists host properties contains the
following entries:
C:\users\doe\john
C:\users\doe\abc\
C:\users\*\test
C:\*\temp

142

Configuring Host Properties

Exclude Lists properties

core

Given the exclude list example, the following files, and directories are excluded
from automatic backups:

The file or directory named C:\users\doe\john.

The directory C:\users\doe\abc\ (because the exclude entry ends with \).

All files or directories named test that are two levels beneath users on drive
C.

All files or directories named temp that are two levels beneath the root directory
on drive C.

All files or directories named core at any level and on any drive.

Example of a UNIX exclude list

In this example of a UNIX exclude list, the list contains the following entries:
# this is a comment line
/home/doe/john
/home/doe/abc/
/home/*/test
/*/temp
core

Given the exclude list example, the following files and directories are excluded from
automatic backups:

The file or directory named /home/doe/john.

The directory /home/doe/abc (because the exclude entry ends with /).

All files or directories named test that are two levels beneath home.

All files or directories named temp that are two levels beneath the root directory.

All files or directories named core at any level.

About creating an include list on a UNIX client

To add a file that is eliminated with the exclude list, create a
/usr/openv/netbackup/include_list file. The same syntax rules apply as for
the exclude list.
Note: Exclude and include lists do not apply to user backups and archives.

143

Configuring Host Properties

Exclude Lists properties

To illustrate the use of an include list, we use the example from the previous
discussion. The exclude list in that example causes NetBackup to omit all files or
directories named test from all directories beneath /home/*/test.
In this case, add a file named /home/jdoe/test back into the backup by creating
an include_list file on the client. Add the following to the include_list file:
# this is a comment line
/home/jdoe/test

To create an include list for a specific policy or policy and schedule combination,
use a .policyname or .policyname.schedulename suffix. The following are two
examples of include list names for a policy that is named wkstations that contains
a schedule that is named fulls.
/usr/openv/netbackup/include_list.workstations
/usr/openv/netbackup/include_list.workstations.fulls

The first file affects all scheduled backups in the policy that is named wkstations.
The second file affects backups only when the schedule is named fulls.
For a given backup, NetBackup uses only one include list: the list with the most
specific name. Given the following two files:
include_list.workstations
include_list.workstations.fulls

NetBackup uses only include_list.workstations.fulls as the include list.

Configuring the exclude list on a Windows client from a UNIX master

server
An administrator can change the exclude list on a Windows client from a UNIX
master server by using the nbgetconfig (or bpgetconfig) and the nbsetconfig
(or bpsetconfig) commands.

144

Configuring Host Properties

Exclude Lists properties

145

Configuring the exclude list on a Windows client from a UNIX master server

From the UNIX server, use the nbgetconfig command to access the exclude
list on a Windows client.
For example, where:
nbmaster1 is a UNIX master server.
nbmedia1 is a Windows computer and a NetBackup client.
On nbmaster1, run the following command:
/usr/openv/netbackup/bin/admincmd/nbgetconfig -M nbmedia1 EXCLUDE

The output lists the exclude list on nbmedia1:

EXCLUDE
EXCLUDE
EXCLUDE
EXCLUDE
EXCLUDE

=
=
=
=
=

C:\Program
C:\Program
C:\Program
C:\Program
C:\Program

Files\Veritas\NetBackup\bin\*.lock
Files\Veritas\NetBackup\bin\bprd.d\*.lock
Files\Veritas\NetBackup\bin\bpsched.d\*.lock
Files\Veritas\NetBackupDB\data\*
Files\Veritas\Volmgr\misc\*

Create an exclude list on the UNIX server.

For example, file ex_list on nbmaster1:
vi /tmp/ex_list

The contents of ex_list consists of the following files and directories:

more /tmp/ex_list
EXCLUDE = C:\Program
EXCLUDE = C:\Program
EXCLUDE = C:\Program
EXCLUDE = C:\Program
EXCLUDE = C:\Program
EXCLUDE = C:\
EXCLUDE = D:\

Files\Veritas\NetBackup\bin\*.lock
Files\Veritas\NetBackup\bin\bprd.d\*.lock
Files\Veritas\NetBackup\bin\bpsched.d\*.lock
Files\Veritas\NetBackupDB\data\*
Files\Veritas\Volmgr\misc\*

Configuring Host Properties

Exclude Lists properties

146

From the UNIX server, use the nbsetconfig command to set the exclude list
on a Windows client.
For example, run the following command on nbmaster1 to make ex_list the
exclude list on client nbmedia1:
/usr/openv/netbackup/bin/admincmd/nbsetconfig -h nbmedia1 /tmp/ex_list

On the UNIX server, use the nbgetconfig command to view the new exclude
list on the Windows client.
For example:
/usr/openv/netbackup/bin/admincmd/nbgetconfig -M nbmedia1 EXCLUDE

The output lists the updated exclude list on nbmedia1:

EXCLUDE
EXCLUDE
EXCLUDE
EXCLUDE
EXCLUDE
EXCLUDE
EXCLUDE

=
=
=
=
=
=
=

C:\Program
C:\Program
C:\Program
C:\Program
C:\Program
C:\
D:\

Files\Veritas\NetBackup\bin\*.lock
Files\Veritas\NetBackup\bin\bprd.d\*.lock
Files\Veritas\NetBackup\bin\bpsched.d\*.lock
Files\Veritas\NetBackupDB\data\*
Files\Veritas\Volmgr\misc\*

Traversing excluded directories

An exclude list can indicate a directory for exclusion, while the client uses an include
list to override the exclude list. NetBackup traverses the excluded directories if
necessary, to satisfy the clients include list.
Assume the following settings for a Windows client:

The backup policy backup selection list indicates ALL_LOCAL_DRIVES. When a

scheduled backup runs, the entire client is backed up.
The entire client is also backed up if the backup selection list consists of only:
/

The exclude list on the client consists of only: *

An exclude list of * indicates that all files are excluded from the backup.

However, since the include list on the Windows client includes the following file:
C:\WINNT, the excluded directories are traversed to back up C:\WINNT.
If the include list did not contain any entry, no directories are traversed.

In another example, assume the following settings for a UNIX client:

The backup selection list for the client consists of the following: /

Configuring Host Properties

Fibre Transport properties

The exclude list for the UNIX client consists of the following: /

The include list of the UNIX client consists of the following directories:
/data1
/data2
/data3

Because the include list specifies full paths and the exclude list excludes everything,
NetBackup replaces the backup selection list with the clients include list.

Fibre Transport properties

NetBackup Fibre Transport properties control how your Fibre Transport media
servers and SAN clients use the Fibre Transport service for backups and restores.
The Fibre Transport properties apply to the host type that you select in the
NetBackup Administration Console, as follows:
Table 3-34

Host types for Fibre Transport properties

Host type

Description

Master server

Global Fibre Transport properties that apply to all SAN clients.

Media server

The Fibre Transport Maximum concurrent FT connections

property applies to the FT media server or servers that you selected
in the NetBackup Administration Console.

Client

The Fibre Transport properties apply to the SAN client or clients

that you selected in the NetBackup Administration Console. The
default values for clients are the global property settings of the master
server. Client properties override the global Fibre Transport
properties.

147

Configuring Host Properties

Fibre Transport properties

Figure 3-29

Fibre Transport host properties for a master server

Table 3-35 describes the Fibre Transport properties. All properties are not available
for all hosts. In this table, FT device is an HBA port on a Fibre Transport media
server. The port carries the backup and restore traffic. A media server may have
more than one FT device.
Table 3-35

Fibre Transport dialog box properties

Property

Description

Maximum concurrent FT
connections

This property appears only when you select an FT media server or servers in the
NetBackup Administration Console.
This property specifies the number of FT connections to allow to the selected
media server or media servers. A connection is equivalent to a job.
The default is four times the number of HBA target ports. The maximum that you
can enter is 20.
On Linux hosts, you can increase that maximum by setting a NetBackup touch
file, NUMBER_DATA_BUFFERS_FT.
See About Linux concurrent FT connections on page 150.

148

Configuring Host Properties

Fibre Transport properties

Table 3-35

Fibre Transport dialog box properties (continued)

Property

Description

Use defaults from the master

server configuration

This property appears only when you select a client or client in the NetBackup
Administration Console.
This property specifies that the client follow the properties as they are configured
on the master server.

Preferred

The Preferred property specifies to use an FT device if one is available within

the configured wait period in minutes. If an FT device is not available after the
wait period elapses, NetBackup uses a LAN connection for the operation.
If you select this option, also specify the wait period for backups and for restores.
For the global property that is specified on the master server, the default is
Preferred.

Always

The Always property specifies that NetBackup should always use an FT device
for backups and restores of SAN clients. NetBackup waits until an FT device is
available before it begins the operation.
However, an FT device must be online and up. If not, NetBackup uses the LAN.
An FT device may be unavailable because none are active, none have been
configured, or the SAN Client license expired.

Fail

The Fail property specifies that NetBackup should fail the job if an FT device is
not online and up. If the FT devices are online but busy, NetBackup waits until a
device is available and assigns the next job to the device. An FT device may be
unavailable because none are active, none have been configured, or the SAN
Client license expired.

Never

The Never property specifies that NetBackup should never use an FT pipe for
backups and restores of SAN clients. NetBackup uses a LAN connection for the
backups and restores.
If you specify Never for the master server, Fibre Transport is disabled in the
NetBackup environment. If you select Never, you can configure FT usage on a
per-client basis.
If you specify Never for a media server, Fibre Transport is disabled for the media
server.
If you specify Never for a SAN client, Fibre Transport is disabled for the client.

NetBackup provides one finer level of granularity for Fibre Transport. SAN client
usage preferences override the FT properties that you configure through Host
Properties.
For more information about NetBackup Fibre Transport, see the NetBackup SAN
Client and Fibre Transport Guide available through the following URL:

149

Configuring Host Properties

Firewall properties

http://www.symantec.com/docs/DOC5332

About Linux concurrent FT connections

NetBackup uses the Maximum concurrent FT connections Fibre Transport host
property to configure the number of concurrent connections to a Fibre Transport
media server, up to the total that is allowed per host.
See Fibre Transport properties on page 147.
On the Linux x86_64 computers that host FT media servers, Symantec recommends
that you use 20 or fewer pipes concurrently. To use more than 20 concurrent
connections, configure the number of data buffers per FT connection to 10. To do
so, create (if necessary) the following file and include the integer 10 as the only
contents:
/usr/openv/netbackup/db/config/NUMBER_DATA_BUFFERS_FT

With 10 buffers per connection, NetBackup supports 32 buffers per connection.

The consequence is that each client backup or restore job is slower because of
fewer buffers. NetBackup supports 322 buffers per media server for Fibre Transport.

Firewall properties
The Firewall properties describe how the selected master servers, media servers,
and indexing servers are connected to by other hosts.
Servers are added to the host list of the Firewall properties. To configure port usage
for clients, see the Client Attributes properties.
See Client Attributes properties on page 93.

150

Configuring Host Properties

Firewall properties

Figure 3-30

Firewall dialog box

The Firewall dialog box contains the following properties.

151

Configuring Host Properties

Firewall properties

Table 3-36

Firewall dialog box properties

Property

Description

Default connect options

By default, NetBackup selects firewall-friendly connect options under Default connect

options. However, the default options can be set differently for individual servers under
Attributes for selected Hosts.
By default, the firewall settings are configured to require the fewest possible ports to
be open.
These properties correspond to the DEFAULT_CONNECT_OPTIONS configuration option.
To change the default connect options for the selected server, click Change.
Click Change to change the Default connect options. Change the Firewall properties
in the Default Connect Options dialog box.

Note: If VNETD only is selected as the Daemon connection port, the BPCD connect
back setting is not applicable. If VNETD only is selected as the Daemon connection
port, Use non-reserved ports is always used regardless of the value of the Ports
setting.
Hosts list

To change the default connect options for any server, add the server to the host list.
Servers do not automatically appear on the list.

Attributes for selected hosts

Add option
Click Add to add a host entry to the host list. A host must be listed before it can be
selected for configuration.
Add to all option
Click Add to All to add the listed hosts (along with the specified properties) to all
hosts that are selected for host property configuration. (That is, the hosts that are
selected upon opening the Host Properties.)
Remove option
Select a host name in the list, then click Remove to remove the host from the list.

Connect options can be configured for individual servers.

These properties correspond to the CONNECT_OPTIONS configuration option.

152

Configuring Host Properties

Firewall properties

Table 3-36

Firewall dialog box properties (continued)

Property

Description

BPCD connect back

This property specifies how daemons are to connect back to the NetBackup Client
daemon (BPCD) as follows:

Use default connect options (An option for individual hosts)

Use the methods that are specified under Default connect options.
Random port
NetBackup randomly chooses a free port in the allowed range to perform the
traditional connect-back method.
VNETD port
This method requires no connect-back. The Veritas Network Daemon (vnetd) was
designed to enhance firewall efficiency with NetBackup during server-to-server and
server-to-client communications. The server initiates all bpcd socket connections.
Consider the example in which bpbrm on a media server initially connects with
bpcd on a client. The situation does not pose a firewall problem because bpbrm
uses the well-known bpcd port.

Ports

Select whether a reserved or non-reserved port number should be used to connect to

the server:

Use default connect options (An option for individual hosts)

Use the methods that are specified under Default attributes.
Reserved port
Connect to the server by a reserved port number.
Use non-reserved ports
Connect to the server by a non-reserved port number. If this property is selected,
also enable Accept connections from non-reserved ports for the selected server
in the Universal Settings properties.
See Universal Settings properties on page 253.

153

Configuring Host Properties

General Server properties

Table 3-36

Firewall dialog box properties (continued)

Property

Description

Daemon connection port

This option only affects connections to NetBackup 7.0 and earlier. For connections to
NetBackup 7.0.1 and later, the veritas_pbx port is used.
If configuring connections for NetBackup 7.0 and earlier, select the Daemon connection
port method to use to connect to the server:

Use default connect options (An option for individual hosts)

Use the methods that are specified under Default connect options.
Automatic
The daemons on the server are connected to by vnetd if possible. If it is not possible
to use vnetd, the daemons traditional port number makes the connection.
VNETD only
The daemons on the server are connected to by vnetd only. Select this property
if your firewall rules prevent connections to the server by the traditional port number.
Daemon port only
The daemons on the server are connected to by the traditional port number only.

Note: If vnetd only is selected as the Daemon connection port, the BPCD connect
back setting is not applicable. If vnetd only is selected as the Daemon connection
port, Non-reserved port is always used regardless of the value of the Ports setting.
Defaults

Set property settings back to the defaults.

Enabling logging for vnetd

Use the following procedure to enable logging for vnetd.
To enable logging for vnetd

Create a vnetd directory in the following location:

On Windows: install_path\NetBackup\logs\vnetd
Or, double-click mklogdir.bat in the install_path\NetBackup\logs\
directory to populate the logs directory with log subdirectories, including
one for vnetd.

On UNIX: /usr/openv/logs/vnetd

General Server properties

The General Server properties apply to selected master and media servers.

154

Configuring Host Properties

General Server properties

Figure 3-31

General Server dialog box

The General Server dialog box contains the following properties.

Table 3-37

General Server dialog box properties

Property

Description

Delay on multiplexed restores

This property specifies how long the server waits for additional restore requests
of multiplexed images on the same tape. All of the restore requests that are
received within the delay period are included in the same restore operation (one
pass of the tape).
The default is a delay of 30 seconds.

Check the capacity of disk storage This property determines how often NetBackup checks disk storage units for
units every
available capacity. If checks occur too frequently, then system resources are
wasted. If checks do not occur often enough, too much time elapses and backup
jobs are delayed.
The default is 300 seconds (5 minutes).

Note: This property applies to the disk storage units of 6.0 media servers only.
Subsequent releases use internal methods to monitor disk space more frequently.

155

Configuring Host Properties

General Server properties

Table 3-37

General Server dialog box properties (continued)

Property

Description

Must use local drive

This property appears for master servers only, but applies to all media servers
as well. This property does not apply to NDMP drives.
If a client is also a media server or a master server and Must use local drive is
checked, a local drive is used to back up the client. If all drives are down, another
can be used.
This property increases performance because backups are done locally rather
than sent across the network. For example, in a SAN environment a storage unit
can be created for each SAN media server. Then, the media server clients may
be mixed with other clients in a policy that uses ANY AVAILABLE storage unit.
When a backup starts for a client that is a SAN media server, the backups go to
the SAN connected drives on that server.

Use direct access recovery for

NDMP restores

By default, NetBackup for NDMP is configured to use Direct Access Recovery

(DAR) during NDMP restores. DAR can reduce the time it takes to restore files
by allowing the NDMP host to position the tape to the exact location of the
requested file(s). Only the data that is needed for those files is read.
Clear this check box to disable DAR on all NDMP restores. Without DAR,
NetBackup reads the entire backup image, even if only a single restore file is
needed.

Enable message-level cataloging

when duplicating Exchange images
that use Granular Recovery
Technology

This option performs message-level cataloging when you duplicate Exchange

backup images that use Granular Recovery Technology (GRT) from disk to tape.
To perform duplication more quickly, you can disable this option. However, then
users are not able to browse for individual items on the image that was duplicated
to tape.
See the NetBackup for Exchange Adminstrator's Guide.

156

Configuring Host Properties

General Server properties

Table 3-37

General Server dialog box properties (continued)

Property

Description

Media host override list

Specific servers can be specified in this list as servers to perform restores,

regardless of where the files were backed up. (Both servers must be in the same
master and media server cluster.) For example, if files were backed up on media
server A, a restore request can be forced to use media server B.
The following items describe situations in which the capability to specify servers
is useful:

Two (or more) servers share a robot and each have connected drives. A restore
is requested while one of the servers is either temporarily unavailable or is
busy doing backups.
A media server was removed from the NetBackup configuration, and is no
longer available.

To add a host to the Media host override list, click Add.

Click Add to All to add a host to the list for all of the hosts currently selected.
To change an entry in the list, select a host name, then click Change.
Configure the following options in the Add Media Override settings or Change
Media Override settings dialog box:

Defaults

Original backup server

Type the name of the server where data was backed up originally.
Restore server
Type the name of the server that is to process future restore requests.

Sets all properties back to the default settings.

Forcing restores to use a specific server

Use the following procedure to force restores to use a specific server.

157

Configuring Host Properties

Global Attributes properties

To force restores to use a specific server

If necessary, physically move the media to the host to answer the restore
requests, then update the Enterprise Media Manager database to reflect the
move.

Modify the NetBackup configuration on the master server. Add the original
backup media server and the restore server to the Media host override list in
the General Server host properties.

Stop and restart the NetBackup Request Daemon (bprd) on the master server.
This process applies to all storage units on the original backup server. Restores
for any storage unit on the Original backup server go to the server that is
listed as the Restore server.
To revert to the original configuration for future restores, delete the line from
the Media host override list.

Global Attributes properties

The Global Attributes properties apply to currently selected master servers. The
Global Attributes properties affect all operations for all policies and clients. The
default values are adequate for most installations but can be changed.

158

Configuring Host Properties

Global Attributes properties

Figure 3-32

Global Attributes dialog box

The Global Attributes dialog box contains the following properties.

Table 3-38

Global Attributes dialog box properties

Property

Description

Job retry delay

This property specifies how often NetBackup retries a job. The default is 10 minutes.
The maximum is 60 minutes; the minimum is 1 minute.

159

Configuring Host Properties

Global Attributes properties

Table 3-38
Property

Global Attributes dialog box properties (continued)

Description

Schedule backup attempts NetBackup considers the failure history of a policy to determine whether or not to run
a scheduled backup job. The Schedule backup attempts property sets the timeframe
for NetBackup to examine.
This property determines the following characteristics for each policy:

How many preceding hours NetBackup examines to determine whether to allow

another backup attempt (retry). By default, NetBackup examines the past 12 hours.
How many times a backup can be retried within that timeframe. By default,
NetBackup allows two attempts. Attempts include the scheduled backups that start
automatically or the scheduled backups that are user-initiated.

Consider the following example scenario using the default setting 2 tries every 12
hours:

Policy_A runs at 6:00 P.M.; Schedule_1 fails.

Policy_A is user-initiated at 8:00 P.M.; Schedule_2 fails.

At 11:00 P.M., NetBackup looks at the previous 12 hours. NetBackup sees one
attempt at 6:00 P.M. and one attempt at 8:00 P.M. The Schedule backup attempts
setting of two has been met so NetBackup does not try again.
At 6:30 A.M. the next morning, NetBackup looks at the previous 12 hours. NetBackup
sees only one attempt at 8:00 P.M. The Schedule backup attempts setting of two
has not been met so NetBackup tries again. If a schedule window is not open at
this time, NetBackup waits until a window is open.

Note: This attribute does not apply to user backups and archives.
Policy update interval

This property specifies how long NetBackup waits to process a policy after a policy is
changed. The interval allows the NetBackup administrator time to make multiple changes
to the policy. The default is 10 minutes. The maximum is 1440 minutes; the minimum
is 1 minute.

Maximum indexing jobs per This property specifies the maximum number of indexing jobs that run concurrently on
indexing server
an indexing server. The default value is 10.
For example, if you set the value to 5, then up to five jobs can run in parallel. If more
than five jobs are submitted, the additional jobs remain queued until a running job
completes.

160

Configuring Host Properties

Global Attributes properties

Table 3-38

Global Attributes dialog box properties (continued)

Property

Description

Maximum jobs per client

This property specifies the maximum number of backup and archive jobs that NetBackup
clients can perform concurrently. The default is one job.
NetBackup can process concurrent backup jobs from different policies on the same
client only in the following situations:

More than one storage unit available

One of the available storage units can perform more than one backup at a time.

See About constraints on the number of concurrent jobs on page 161.

Compress catalog interval

This property specifies how long NetBackup waits after a backup before it compresses
the image catalog file.

Maximum vault jobs

This property specifies the maximum number of vault jobs that are allowed to be active
on the master server. The greater the maximum number of vault jobs, the more system
resources are used.
If the active vault jobs limit is reached, subsequent vault jobs are queued and their
status is shown as Queued in the Activity Monitor.
If a duplication job or eject job waits, its status is shown as Active in the Activity Monitor.
See About the Jobs tab on page 1019.

Administrator email
address property

This property specifies the address(es) where NetBackup sends notifications of

scheduled backups or administrator-directed manual backups.
To send the information to more than one administrator, separate multiple email
addresses by using a comma, as follows:
[email protected],[email protected]
Disaster recovery information that is created during catalog backups is not sent to the
addresses indicated here. Disaster recovery information is sent to the address that is
indicated on the Disaster Recovery tab in the catalog backup policy.
See Disaster Recovery tab on page 828.

About constraints on the number of concurrent jobs

Specify any number of concurrent jobs within the following constraints.

161

Configuring Host Properties

Global Attributes properties

Constraints on concurrent jobs

Table 3-39
Constraint

Description

Number of storage devices

NetBackup can perform concurrent backups to separate storage units or to drives

within a storage unit. For example, a single Media Manager storage unit supports as
many concurrent backups as it has drives. A disk storage unit is a directory on disk,
so the maximum number of jobs depends on system capabilities.

Server and client speed

Too many concurrent backups on an individual client interfere with the performance
of the client. The best setting depends on the hardware, operating system, and
applications that are running.
The Maximum jobs per client property applies to all clients in all policies.
To accommodate weaker clients (ones that can handle only a small number of jobs
concurrently), consider using one of the following approaches:

Network loading

Set the Maximum data streams property for those weaker client(s) appropriately.
(This property is found under Host Properties > Master Server > Client Attributes
> General tab.)
See General tab of the Client Attributes properties on page 95.
Use the Limit jobs per policy policy setting in a client-specific policy. (A
client-specific policy is one in which all clients share this characteristic).
See Limit jobs per policy (policy attribute) on page 684.

The available bandwidth of the network affects how many backups can occur
concurrently. Two Exabyte 8500, 8mm tape drives can create up to a
900-kilobyte-per-second network load. Depending on other factors, the load might be
too much for a single Ethernet. For loading problems, consider backups over multiple
networks or compression.
A special case exists to back up a client that is also a server. Network loading is not a
factor because the network is not used. Client and server loading, however, is still a
factor.

Figure 3-33

Maximum jobs per client

Client
/home

Policy A

/usr

Policy B

Tape Drive 1

Tape Drive 2
Server

162

Configuring Host Properties

Global Attributes properties

Note: Catalog backups can run concurrently with other backups. To do so, set the
Maximum jobs per client value to greater than two for the master server. The
higher setting ensures that the catalog backup can proceed while the regular backup
activity occurs.

Setting up email notifications about backups

Email notifications can be sent to the client's administrator or to the global
administrator, specifying that a backup was successful or unsuccessful.
The following represents the contents of a notification email:
Backup on client hostname by root was partially successful.
File list
--------C:\Documents and Settings

Before emails can be sent, the computing environment must be configured correctly.

Additional Windows configuration to receive emails

NetBackup can send notification to specified email addresses about backups on
all clients or specific clients.
The nbmail.cmd script must be configured on any Windows host that is to receive
email.
Windows systems also require that an application to transfer messages using the
Simple Mail Transfer Protocol be installed to accept script parameters. UNIX
platforms have an SMTP transfer method built into the system.

Additional UNIX configuration to receive emails

NetBackup uses the mail transfer agent sendmail to send email notifications. Install
sendmail from the following website and configure the environment accordingly:
http://www.sendmail.org/releases

Notification methods
To set up email notifications about backups, choose one or both of the following
notification methods:

Send emails about failed backups only.

Send a message to the email address(es) of the NetBackup administrator(s)
about any backup that ends in a non-zero status.
To do so, configure the Administrator email address in the Global Attributes
properties. Since email is sent from the master server or the media server, the

163

Configuring Host Properties

Global Attributes properties

nbmail.cmd script or sendmail must be configured on the master and media

servers.
See Sending messages to the global administrator about unsuccessful backups
only on page 166.

Send emails about successful and failed backups.

Send a message to the local administrator(s) of each client about successful
and unsuccessful backups.
To do so, configure either the Client sends mail property or the Server sends
mail property in the Universal Settings properties for the client. Email is sent
from the client (Client sends mail) or the master or media server (Server sends
mail). Therefore, nbmail.cmd or sendmail must be configured on the master
and media servers, or the client, if specified.
See Sending messages to the administrator about successful and unsuccessful
backups on page 166.

See Installing and testing the email utility on Windows on page 168.
See About constraints on the number of concurrent jobs on page 161.

Configuring the nbmail.cmd script on Windows

For Windows hosts to receive email notifications about backups, the nbmail.com
script must be configured on the host.
By default, nbmail.cmd does not send email. Use the following procedure to
configure the nbmail.cmd script.
To configure the nbmail.cmd script

On a NetBackup master server, copy nbmail.cmd from the following directory:

install_path\VERITAS\NetBackup\bin\goodies\nbmail.cmd

Paste it into the following directory on the server or client:

install_path\VERITAS\NetBackup\bin\

164

Configuring Host Properties

Global Attributes properties

Use a text editor to open nbmail.cmd. Create a backup copy of nbmail.cmd

before modifying it.
In some text editors, using the word wrap option can create extra line feeds in
the script and render it non-functional.
The following options are used in the script:

-s

The subject line of the email

-t

Indicates who receives the email.

-i

The originator of the email, though it is not necessarily known to the

mail server. The default (-i NetBackup) shows that the email is from
NetBackup.

-server

The name of the SMTP server that is configured to accept and relay
emails.

-q

Suppresses all output to the screen.

Most of the lines are informational in nbmail.cmd.

Locate the following lines in the script:

@REM
@REM
@REM
@REM
@REM

@IF "%~4"=="" (
blat %3 -s %2 -t %1 -i NetBackup -server SERVER_1 -q
) ELSE (
blat %3 -s %2 -t %1 -i NetBackup -server SERVER_1 -q -attach %4
)

Adjust the fives lines as follows:

Remove @REM from each of the five lines to activate the necessary
sections for BLAT to run.

Replace SERVER_1 with the name of the mail server. For example:

@IF "%~4"=="" (
blat %3 -s %2 -t %1 -i NetBackup -server emailserver.company.com -q
) ELSE (
blat %3 -s %2 -t %1 -i NetBackup -server emailserver.company.com -q -attach %4
)

Save nbmail.cmd.

See About constraints on the number of concurrent jobs on page 161.

165

Configuring Host Properties

Global Attributes properties

Sending messages to the global administrator about unsuccessful

backups only
Use the following procedure to send messages to the global administrator about
backups with a non-zero status.
To send messages to the global administrator about backups with a non-zero status

On Windows servers, install and configure a mail client.

See Installing and testing the email utility on Windows on page 168.
Edit the nbmail.cmd script.
See Configuring the nbmail.cmd script on Windows on page 164.

On the master server, open the NetBackup Administration Console.

In the NetBackup Administration Console, expand NetBackup Management

> Host Properties > Master Server.

In the right pane, double-click the master server you want to modify.

Open the host properties of the master server.

In the properties dialog box, in the left pane, click Global Attributes.

In the Administrators email address field, enter the email address of the
administrator to receive the notification emails. (Separate multiple addresses
with commas.) Click Apply.
The global administrators email address can also be changed by using the
bpconfig command on the master server:
Install_Path\NetBackup\bin\admincmd\bpconfig -ma email_address

For example:
C:\Program Files\VERITAS\NetBackup\bin\admincmd\bpconfig
-ma [email protected]

Sending messages to the administrator about successful and

unsuccessful backups
An alternative to sending all emails through the master server is to send emails
through each client or through the media server that backed up the client. An email
can be sent to the administrator after every backup.

166

Configuring Host Properties

Global Attributes properties

To send email notifications for all backups from a client

On a Windows client, install and configure a mail client.

See Installing and testing the email utility on Windows on page 168.
On the client or the media server, edit the nbmail.cmd script, depending on
whether Client sends mail is enabled or Server sends mail is enabled in step
6.
See Configuring the nbmail.cmd script on Windows on page 164.

On the master server, open the NetBackup Administration Console.

In the NetBackup Administration Console, expand NetBackup Management

> Host Properties > Clients.

In the right pane, double-click the client you want to modify. Multiple clients
can also be selected.

In the properties dialog box, in the left pane, select Universal Settings.

Enable the Client sends mail option or if the client cannot send mail, enable
the Server sends mail option.

In the Client administrators email field, enter the email address of the
administrator(s) to receive the notification emails. (Separate multiple addresses
with commas.) Click Apply.
See Universal Settings properties on page 253.

167

Configuring Host Properties

Global Attributes properties

Installing and testing the email utility on Windows

BLAT is the most common application is used for email notification. It is a mail client
in the public domain. BLAT is used as an example in the following discussions.
Use the following procedure to install and configure the email utility.
To install and configure the email utility

Download the .ZIP file from the BLAT download page, currently: www.blat.net

Extract the files to a directory.

Copy the blat.exe file to the Windows System32 directory.

From a command prompt, run the following command:

blat -install emailserver.company.com [email protected]

Where:
emailserver.company.com is the hostname or IP address of the mail server
that sends the email notifications.
[email protected] is the primary account to send the emails from
the specified server.

Test the email utility, following the To test the email utility procedure.

Use the following procedure to test the email utility.

To test the email utility

Create a test text file that contains a message. For example, create
C:\testfile.txt

From a command prompt, run:

blat C:\testfile.txt -s test_subject -to [email protected]

A correct setup sends the contents of testfile.txt to the email address

specified.

Use the following list to troubleshoot problems if NetBackup notification does

not work correctly:

Make sure that the BLAT command is not commented out in the nbmail.cmd
script.

Make sure that the path to blat.exe is specified in nbmail.cmd if the

command is not in the \system32 directory.

Make sure that BLAT syntax has not changed in the later versions of BLAT.
Check the readme for the version of BLAT running on the system.

168

Configuring Host Properties

Logging properties

The BLAT command may need the -ti n timeout parameter if the system
experiences delays. (n represents seconds.)

The BLAT binary must not be corrupt or incompatible with the email system.
Download the latest version.

Configure the email addresses correctly in the host properties.

The email account that is specified must be a valid on the mail server.

If the mail server requires authentication for SMTP, make sure that the
account that is used for the NetBackup client process is authorized. The
default account is the local system.

Logging properties
The Logging properties apply to the master servers, media servers, indexing
servers, and clients that are currently selected. The available properties differ
between master servers, media servers, and clients.
The Logging properties contain the processes that continue to use Legacy logging
as well as processes that use Unified logging.

Legacy logging
For those processes that use legacy logging, administrators must first create a log
directory for each process to be logged. A logging level selection on the Logging
properties page does not enable logging.
Create the NetBackup legacy log directories in the following locations:

On Windows: install_path\NetBackup\logs\process_name

UNIX: /usr/openv/netbackup/logs/process_name

Note: Do not save logs to a remote file system such as NFS or CIFS. Logs that are
stored remotely and then grow large can cause critical performance issues.
You can create all of the NetBackup debug log directories at one time by running
the mklogdir.bat on Windows and mklogdir shell script on UNIX in the following
directory:

On Windows: install_path\NetBackup\logs\

On UNIX: /usr/openv/netbackup/logs

Create the Media Manager legacy log directories in the following locations:

On Windows: install_path\Volmgr\debug

169

Configuring Host Properties

Logging properties

On UNIX: /usr/openv/volmgr/debug

Unified logging
Unified logging creates log file names and messages in a format that is standardized
across Symantec products. Some NetBackup processes on the server use unified
logging.
Unified logging writes the logs into subdirectories in the following locations:

On Windows: install_path\NetBackup\logs

On UNIX: /usr/openv/logs

Unlike legacy logging, subdirectories for the processes that use unified logging are
created automatically.
Note: Do not save logs to a remote file system such as NFS or CIFS. Logs that are
stored remotely and then grow large can cause critical performance issues.
In case of unified logging, NetBackup uses the nblog.conf configuration file to set
maximum size of a log file. Use the vxlogcfg command to configure the following
log settings in the nblog.conf file: MaxLogFileSizeKB and NumberOfLogFiles
Configure the MaxLogFileSizeKB parameter to set maximum size of a log file. When
the log file size in NetBackup matches the MaxLogFileSizeKB setting, the next logs
are stored in a new log file.
Configure the NumberOfLogFiles parameter to set maximum number of log files
that you want to be created in NetBackup. When the number of log files in NetBackup
matches the NumberOfLogFiles setting, the older log files are purged.
The NetBackup Troubleshooting Guide contains more information about controlling
the log file size.
Note: Do not edit the nblog.conf file manually.
See the NetBackup Commands Guide for information on the vxlogcfg command
and the nblog.conf file.
For details on both unified and legacy logging, see the NetBackup Troubleshooting
Guide.

170

Configuring Host Properties

Logging properties

Figure 3-34

Logging dialog box

The Logging dialog box contains the following properties.

171

Configuring Host Properties

Logging properties

Table 3-40

Logging dialog box properties

Property

Description

Enable robust logging

A check in the Enable robust logging check box indicates that when a log file grows
to the maximum size, the log file is closed. When the log file is closed, a new log file
is opened. If the new log file causes the maximum number of log files in the directory
to be exceeded, the oldest log file is deleted.
See the NetBackup Troubleshooting Guide for more information about controlling the
log file size.
If this property is enabled, the following processes produce log files:

bprd

bpbkar

bpbrm

bpcd

bpdbm

bptm

bpdm

The logs are named using the following convention:

MMDDYY_NNNNN.log
where NNNNN is an incrementing counter from 00001 - 99999
If the Enable robust logging property is disabled, a single log file is produced each
day:
MMDDYY.log
Whether Enable robust logging is selected or not, the log file is pruned by using
KEEP_LOGS_DAYS and DAYS_TO_KEEP_LOGS settings.

Note: If a NetBackup environment uses scripts depending on the MMDDYY.log naming

convention, either update the scripts or disable the Enable robust logging option.
Global logging level

This property is used for debugging purposes. The logging levels control the amount
of information that the NetBackup server writes to logs. Six levels are supported. Select
from between 0 (minimum logging level) through 5 (maximum logging level).

Note: Use the default setting of 0 unless advised otherwise by Symantec Technical
Support. Other settings can cause the logs to accumulate large amounts of information.
Some NetBackup processes allow individual control over the amount of information
the process writes to logs. For those processes, specify a different logging level other
than the Global logging level.

172

Configuring Host Properties

Logging properties

Table 3-40
Property

Logging dialog box properties (continued)

Description

Process specific overrides The services that are listed under Process specific overrides use legacy logging.
These services require that you first create a log directory in the following location:

On Windows: install_path\NetBackup\logs\process_name

On UNIX: /usr/openv/netbackup/logs/process_name

Table 3-41 lists and describes the processes that use legacy logging.
Debug logging levels for
NetBackup services

The Logging properties page offers configurable debug levels for the services that
use unified logging.
Each service creates a log automatically in the following directories:

On Windows: install_path\NetBackup\logs

On UNIX: /usr/openv/logs

You can also use the vxlogcfg command to change debug levels.
Table 3-42 lists and describes the services that use unified logging.

Table 3-41

Process specific overrides

Service

Description

BPBRM logging level

The NetBackup backup and restore manager.

BPTM logging level

The NetBackup tape manager.

BPDM logging level

The NetBackup disk manager.

BPJOBD logging level

The NetBackup Jobs Database Management daemon.

BPDBM logging level

The NetBackup database manager.

BPRD logging level

The NetBackup request daemon or manager.

Table 3-42

Debug logging levels for NetBackup services

Service

Description

Policy Execution Manager

This property appears for master servers.

NBPEM creates Policy/Client tasks and
determines when jobs are due to run. If a
policy is modified or if an image expires,
NBPEM is notified and the appropriate
Policy/Client tasks are updated.

173

Configuring Host Properties

Login Banner Configuration properties

Table 3-42

Debug logging levels for NetBackup services (continued)

Service

Description

Job Manager

This property appears for master servers.

NBJM accepts the jobs that the Policy
Execution Manager submits and acquires the
necessary resources.

Resource Broker

NBRB makes the allocations for storage units,

tape drives, client reservations.

Login Banner Configuration properties

Use the Login Banner Configuration properties to configure a banner screen that
appears each time a user logs into the NetBackup Administration Console or
the Backup, Archive, and Restore client console. The Login Banner
Configuration properties can be configured to make it mandatory for the user to
acknowledge the login banner screen before the user can access the console.
A different login banner can be configured for any master server, media server, or
client.
Figure 3-35 shows example banner text for a media server.

174

Configuring Host Properties

Login Banner Configuration properties

Figure 3-35

Login Banner Configuration dialog box

The first time that the NetBackup Administration Console is launched, the Login
Banner Configuration properties are not configured so no banner appears to the
user. The Login Banner Configuration host properties must be configured in order
for the banner to appear.
The user can change the server once they log into the console. (On the File menu,
click Change Server.) If the banner is configured for the remote server, the banner
appears on the remote server as well.
Note: The banner is not available on NetBackup versions earlier than 6.5.4. If a
user changes to a host that is at NetBackup version 6.5.3 or earlier, no banner
appears.
If a user opens a new console or window from the existing console, the banner
does not appear for the new window. (On the File menu, click the New Console
option or the New Window from Here option.)

175

Configuring Host Properties

Login Banner Configuration properties

Table 3-43

Login Banner Configuration dialog box properties

Property

Description

Login Banner Heading

Enter the text that is to appear in the banner.

Text of login banner

Enter the text for the banner message. The maximum is 29,000 characters.

Show Agree and Disagree buttons on Configure this option when approval is necessary to use the NetBackup
the login banner
Administration Console or the Backup, Archive, and Restore client
console. Specific approval may be required due to a legal agreement at the
company in which the NetBackup environment resides.
If this option is enabled, users are required to click the Agree option and
then click OK before the console opens. The agreement is meant only for
the user that reads and agrees to the message.
If the user chooses the Disagree option, the screen is closed.

Figure 3-36

Login Banner with agreement option enabled

176

Configuring Host Properties

Login Banner Configuration properties

Figure 3-37

Login Banner without agreement option

Removing login banner screen and text

To remove the banner and the text that appears after a user logs into NetBackup,
use the following procedure:
To remove the login banner screen and text

In the NetBackup Administration Console, expand NetBackup Management

> Host Properties.

Depending on the host that displays the login banner, select Master Servers,
Media Servers, or Clients).

In the right pane, double-click the host name to display the properties.

In the properties dialog box, in the left pane, click the Login Banner
Configuration host properties.

Clear the Login Banner Heading text and the login banner text.

Click OK to save the changes.

Enabling the Auto log off timeout option

A related option, but one not configured in the Login Banner Configuration host
properties, is the Auto log off timeout option.
The Auto log off timeout option allows NetBackup to automatically log a user out
of the NetBackup Administration Console after a period of inactivity. The session

177

Configuring Host Properties

Lotus Notes properties

must be inactive for the configurable number of minutes, hours, or days before the
logoff.
To enable the Auto log off timeout option

Select View > Options. Then select the Administrative Options tab (UNIX)
or the Administration Console tab (Windows).

Check the Auto log off timeout option.

Select the duration after which the user is logged off from an inactive session.
The minimum logoff duration is 10 minutes and the maximum is two days.
Five minutes before the timeout value is reached, NetBackup warns that the
session is to expire in five minutes.

If the logoff warning appears, the user can choose one of the following options:

Ignore
If the user selects this option (or does not respond to the warning), a dialog
box displays the time that remains before the session ends. Countdown
warnings display every minute until the timeout value is reached. When the
session ends, the user is logged out of the NetBackup Administration
Console or the Backup, Archive, and Restore client console.

Extend
If the user selects this option, the session continues and the timeout extends
by the logoff timeout value.
If the user begins to work at the console again, the logoff is canceled until
the console is left idle again.

Log off
If the user selects this option, the session ends and NetBackup logs off the
user immediately.

Lotus Notes properties

The Lotus Notes properties apply to the clients that are currently selected and that
run NetBackup for Lotus Notes.
For more information, see the NetBackup for Lotus Notes Administrators Guide.

178

Configuring Host Properties

Lotus Notes properties

Figure 3-38

Lotus Notes dialog box

The following properties can be configured in the Lotus Notes host properties or
by using the nbgetconfig and nbsetconfig commands.
See Methods to set the NetBackup configuration options on page 67.
For UNIX servers: If you have multiple installations of Domino server, the values
in the client properties or the bp.conf only apply to one installation. For other
installations, specify the installation path and location of the notes.ini file with the
LOTUS_INSTALL_PATH and NOTES_INI_PATH directives in the backup policy.

179

Configuring Host Properties

Lotus Notes properties

Table 3-44

Lotus Notes client host properties

Client host
properties

Configuration options

Description

Maximum
number of
logs to
restore

LOTUS_NOTES_LOGCACHESIZE The maximum number of logs that can be prefetched in a single

restore job during recovery. Specify a value greater than 1.
In the Windows registry, this value
is a DWORD value.
If this value is less than or equal to 1, NetBackup does not gather
transaction logs during recovery. One transaction log extent per
job is restored to the Domino servers log directory.
LOTUS_NOTES_LOGCACHESIZE = 3

Transaction
log cache
path

LOTUS_NOTES_LOGCACHEPATH Specify a path where NetBackup can temporarily store the

prefetched transaction logs during recovery.
In the Windows registry, this value
For example:
is a string value.

On Windows: D:\LogCache

On UNIX: /tmp/logcache

If you do not specify a path, during recovery NetBackup restores

the logs to the Domino server's transaction log directory.
Note the following before specifying the Transaction log cache
path:

If the specified path does not exist then it is created during

restore.
The restore job fails with a Status 5 error if the user does not
have write permission for the folder.
Transaction logs are restored to the original location, the
Domino transaction log directory, if a path is not specified.
If the value of Maximum number of logs to restore is less
than or equal to 1 then this path is ignored. The logs are not
prefetched; one transaction log per job is restored to the
Domino Servers log directory.
If there is not sufficient space to restore the specified number
of logs, NetBackup tries to restore only the number of logs
that can be accommodated.

180

Configuring Host Properties

Lotus Notes properties

Table 3-44

Lotus Notes client host properties (continued)

Client host
properties

Configuration options

Description

INI path

LOTUS_NOTES_INI

Enter the NOTES.INI file that is associated with the server used
to back up and restore the Lotus database. Use this setting to
specify the correct .INI file to back up and restore from Domino
partitioned servers. Specifying the .INI file for non-partitioned
servers is not necessary.

In the Windows registry, this value

is a string value.

Specify the absolute path to the NOTES.INI file:

On Windows:
If the notes.ini file is not located in the default directory,
indicate its location in the INI path box. For example:
D:\Lotus\Domino\notes.ini

On UNIX:
If the notes.ini is not located in the directory that is specified
in the Path, indicate its location here. For example:
/db/notesdata/notes.ini
Include the directory and the notes.ini file name.

Path

LOTUS_NOTES_PATH
In the Windows registry, this value
is a string value.

Specify the path where the Lotus Notes program files reside on
the client. NetBackup must know where these files are to perform
backup and restore operations. The value in this box overrides
the Lotus registry key, if both are defined.
Specify the path where the Lotus Notes program files reside on
the client:

On Windows:
Specify the path for Lotus program directory (where
nserver.exe resides). For example:
D:\Lotus\Domino

On UNIX:
Specify a path that includes the Domino data directory, the
Lotus program directory, and the Lotus resource directory.
For example:
/export/home/notesdata:/opt/lotus/notes/latest
/sunspa:/opt/lotus/notes/latest/sunspa/res/C

The Path value overrides the Lotus registry value, if both are
defined.

181

Configuring Host Properties

Media properties

Media properties
The Media properties apply to the master servers and media servers that are
currently selected. Media properties control how NetBackup manages media.
Figure 3-39

Media dialog box

The Media dialog box contains the following properties.

182

Configuring Host Properties

Media properties

Table 3-45

Media dialog box properties

Property

Description

Allow media overwrite

property

This property overrides the NetBackup overwrite protection for specific media types.
Normally, NetBackup does not overwrite certain media types. To disable overwrite
protection, place a check in the check box of one or more of the listed media formats.
For example, place a check in the CPIO check box to permit NetBackup to overwrite
the cpio format.
By default, NetBackup does not overwrite any of the formats on removable media, and
logs an error if an overwrite attempt occurs. This format recognition requires that the
first variable length block on a media be less than or equal to 32 kilobytes.
The following media formats on removable media can be selected to be overwritten:

When ANSI is enabled, ANSI labeled media can be overwritten.

When AOS/VS is enabled, AOS/VS media can be overwritten. (Data General

AOS/VS backup format.)
When CPIO is enabled, CPIO media can be overwritten.

When DBR is enabled, DBR media can be overwritten. (The DBR backup format
is no longer used.)
Remote Storage MTF1 media format. When MTF1 is enabled, Remote Storage
MTF1 media format can be overwritten.
When TAR is enabled, TAR media can be overwritten.

When MTF is enabled, MTF media can be overwritten. With only MTF checked, all
other MTF formats can be overwritten. (The exception is Backup Exec MTF
(BE-MTF1) and Remote Storage MTF (RS-MTF1) media formats, which are not
overwritten.

When BE-MTF1 is enabled, Backup Exec MTF media can be overwritten.

See Results when media overwrites are not permitted on page 186.

183

Configuring Host Properties

Media properties

Table 3-45

Media dialog box properties (continued)

Property

Description

Enable SCSI reserve

This property allows exclusive access protection for tape drives. With access protection,
other host bus adaptors cannot issue commands to control the drives during the
reservation.
SCSI reservations provide protection for NetBackup Shared Storage Option
environments or any other multiple-initiator environment in which drives are shared.
The protection setting configures access protection for all tape drives from the media
server on which the option is configured. You can override the media server setting
for any drive path from that media server.
See Recommended use for Enable SCSI reserve property on page 187.
See Drive path options on page 408.
The following are the protection options:

The SCSI persistent reserve option provides SCSI persistent reserve protection
for SCSI devices. The devices must conform to the SCSI Primary Commands - 3
(SPC-3) standard. SCSI persistent reserve is valid for NetBackup 6.5 and later
servers only. If you enable SCSI persistent reserve, NetBackup does not send
persistent reserve commands to NetBackup media servers earlier than release 6.5.
The SPC-2 SCSI reserve option (default) provides SPC-2 SCSI reserve protection
for SCSI devices. The devices must conform to the reserve and release management
method in the SCSI Primary Commands - 2 standard.
To operate NetBackup without tape drive access protection, clear the Enable SCSI
reserve property. If unchecked, other HBAs can send the commands that may
cause a loss of data to tape drives.

Note: Ensure that all of your hardware processes SCSI persistent reserve commands
correctly. All of your hardware includes Fibre Channel bridges. If the hardware does
not process SCSI persistent reserve commands correctly and NetBackup is configured
to use SCSI persistent reserve, no protection may exist.
Allow multiple retentions
per media

This property lets NetBackup mix retention levels on tape volumes. It applies to media
in both robotic drives and nonrobotic drives. The default is that the check box is clear
and each volume can contain backups of only a single retention level.

Allow backups to span tape This property, when checked, lets backups span to multiple tape media. This property
media
lets NetBackup select another volume to begin the next fragment. The resulting backup
has data fragments on more than one volume. The default is that Allow backups to
span tape media is checked and backups are allowed to span media.
If the end of media is encountered and this property is not selected, the media is set
to FULL and the operation terminates abnormally. This action applies to both robotic
drives and nonrobotic drives.

184

Configuring Host Properties

Media properties

Table 3-45
Property

Media dialog box properties (continued)

Description

Allow backups to span disk This property lets backups span disk volumes when one disk volume becomes full.
The default is that this property is enabled.
The Allow backups to span disk property does not apply to AdvancedDisk or
OpenStorage storage units. Backups span disk volumes within disk pools automatically.
The following destinations support disk spanning:

A BasicDisk storage unit spanning to a BasicDisk storage unit. The units must be
within a storage unit group.
An OpenStorage or AdvancedDisk volume spanning to another volume in the disk
pool.

For disk spanning to occur, the following conditions must be met:

The storage units must share the same media server.

The multiplexing level on spanning storage units should be the same. If there are
any differences, the level on the target unit can be higher.
See Enable multiplexing storage unit setting on page 553.
A disk staging storage unit cannot span to another storage unit. Also, a disk staging
storage unit is not eligible as a target for disk spanning.
Disk spanning is not supported on NFS.

Enable standalone drive

extension

This property lets NetBackup use whatever labeled or unlabeled media is found in a
nonrobotic drive. The default is that the Enable standalone drive extension property
is enabled.

Enable job logging

This property allows the logging of the job information. This logging is the same
information that the NetBackup Activity Monitor uses. The default is that job logging
occurs.

Enable unrestricted media

sharing for all media
servers

This property controls media sharing, as follows:

Enable this property to allow all NetBackup media servers and NDMP hosts in the
NetBackup environment to share media for writing. Do not configure server groups
for media sharing.
Clear this property to restrict media sharing to specific server groups. Then configure
media server groups and backup policies to use media sharing.
Clear this property to disable media sharing. Do not configure media server groups.

The default is that media sharing is disabled. (The property is cleared and no server
groups are configured.)
See About NetBackup server groups on page 361.

185

Configuring Host Properties

Media properties

Table 3-45

Media dialog box properties (continued)

Property

Description

Media ID prefix
(non-robotic)

This property specifies the media ID prefix to use in media IDs when the unlabeled
media is in nonrobotic drives. The prefix must be one to three alpha-numeric characters.
NetBackup appends numeric characters. By default, NetBackup uses A and assigns
media IDs such as A00000, A00001, and so on.
For example, if FEB is specified, NetBackup appends the remaining numeric characters.
The assigned media IDs become FEB000, FEB001, and so on. (Note that this
numbering does not work with the Configure Volumes wizard).

Media unmount delay

To specify a Media unmount delay property indicates that the unloading of media is
delayed after the requested operation is complete. Media unmount delay applies only
to user operations, to include backups and restores of database agent clients, such
as those running NetBackup for Oracle. The delay reduces unnecessary media
unmounts and the positioning of media in cases where the media is requested again
a short time later.
The delay can range from 0 seconds to 1800 seconds. The default is 180 seconds. If
you specify 0, the media unmount occurs immediately upon completion of the requested
operation. Values greater than 1800 are set to 1800.

Media request delay

This property specifies how long NetBackup waits for media in nonrobotic drives. A
configurable delay is useful if a gravity feed stacker is used on a nonrobotic drive. A
delay often exists between dismounting one media and mounting another. The default
is 0 seconds.
During the delay period, NetBackup checks every 60 seconds to see if the drive is
ready. If the drive is ready, NetBackup uses it. Otherwise, NetBackup waits another
60 seconds and checks again. If the total delay is not a multiple of 60, the last wait is
the remainder. If the delay is less than 60 seconds, NetBackup checks after the end
of the delay.
For example, set the delay to 150 seconds. NetBackup waits 60 seconds, checks for
ready, waits 60 seconds, checks for ready, waits 30 seconds, and checks for ready
the last time. If the delay was 50 seconds (a short delay is not recommended),
NetBackup checks after 50 seconds.

Results when media overwrites are not permitted

If media contains one of the protected formats and media overwrites are not
permitted, NetBackup takes the following actions:
If the volume has not been previously
assigned for a backup

Sets the volumes state to FROZEN

Selects a different volume

Logs an error

186

Configuring Host Properties

Media properties

If the volume is in the NetBackup media

catalog and was previously selected for
backups

Sets the volumes state to SUSPENDED

Aborts the requested backup

Logs an error

If the volume is mounted for a backup of the The backup is aborted and an error is logged.
NetBackup catalog
The error indicates the volume cannot be
overwritten.
If the volume is mounted to restore files or list NetBackup aborts the request and logs an
the media contents
error. The error indicates that the volume
does not have a NetBackup format.

Recommended use for Enable SCSI reserve property

All tape drive and bridge vendors support the SPC-2 SCSI reserve and release
method. NetBackup has used SPC-2 SCSI reserve since NetBackup 3.4.3, and it
is the default tape drive reservation method in NetBackup. SPC-2 SCSI reserve is
effective for most NetBackup environments.
The SCSI persistent reserve method provides device status and correction and
may be more effective in the following environments:

Where NetBackup media servers operate in a cluster environment.

NetBackup can recover and use a reserved drive after a failover (if NetBackup
owns the reservation). (With SPC-2 SCSI reserve, the drive must usually be
reset because the reservation owner is inoperative.)

Where the drive has high availability.

NetBackup can resolve NetBackup drive reservation conflicts and maintain high
drive availability. (SPC-2 SCSI reserve provides no method for drive status
detection.)

However, the SCSI persistent reserve method is not supported or not supported
correctly by all device vendors. Therefore, thoroughly analyze the environment to
ensure that all of the hardware supports SCSI persistent reserve correctly.
Symantec recommends careful consideration of all of the following factors before
Enable SCSI reserve is used:

Only a limited number of tape drive vendors support SCSI persistent reserve.

SCSI persistent reserve is not supported or not supported correctly by all Fibre
Channel bridge vendors. Incorrect support in a bridge means no access
protection. Therefore, if the environment uses bridges, do not use SCSI persistent
reserve.

If parallel SCSI buses are used, carefully consider the use of SCSI persistent
reserve. Usually, parallel drives are not shared, so SCSI persistent reserve

187

Configuring Host Properties

NDMP Global Credentials properties

protection is not required. Also, parallel drives are usually on a bridge, and
bridges do not support SCSI persistent reserve correctly. Therefore, if the
environment uses parallel SCSI buses, do not use SCSI persistent reserve.

The operating system tape drivers may require extensive configuration to use
SCSI persistent reserve. For example, if the tape drives do not support SPC-3
Compatible Reservation Handling (CRH), ensure that the operating system does
not issue SPC-2 reserve and release commands.

If any of the hardware does not support SCSI persistent reserve, Symantec
recommends that SCSI persistent reserve is not used.

NDMP Global Credentials properties

The credentials that are entered for NDMP Global Credentials can apply to any
NDMP host in the configuration. However, the Use global NDMP credentials for
this NDMP host option must be selected in the Add NDMP Host dialog box for
the NDMP host.
Figure 3-40

NDMP Global Credentials dialog box

188

Configuring Host Properties

NDMP Global Credentials properties

The NDMP Global Credentials properties dialog box contains the following
properties.
Table 3-46

NDMP Global Credentials dialog box properties

Property

Description

User name

The user name under which NetBackup accesses the NDMP server. This user must
have permission to run NDMP commands.

Password

Enter the password.

Confirm password

Re-enter the password.

To access the Add NDMP Host dialog box, add an NDMP host under Media and
Device Management > Credentials > NDMP Hosts.
Figure 3-41 shows the Add NDMP Host dialog box. In the Credentials section,
select Use global NDMP credentials for this NDMP host so that the NDMP Global
Credentials apply to that host.
Note: Be careful when you add an NDMP host. If you add NDMP host credentials
using the fully qualified domain name (FQDN), you must also indicate the fully
qualified domain name on the client for lookups. That is, the server list in the Backup,
Archive, and Restore administration console must list the NDMP host by the FQDN
as well.
If you add NDMP host credentials using its short name, you can use either the short
name or the FQDN in the client server list.

189

Configuring Host Properties

Network properties

Figure 3-41

Add NDMP Host dialog box

For NDMP Global Credentials

to apply, this must be selected
on the NDMP host as well

Network properties
Use the Network properties to set the properties that define requirements for
communications between clients and the master server. The Network properties
apply to currently selected Windows clients.

190

Configuring Host Properties

Network properties

Figure 3-42

Network dialog box

The Network dialog box contains the following properties.

Table 3-47

Network dialog box properties

Property

Description

NetBackup client service

port (BPCD)

This property specifies the port that the NetBackup client uses to communicate with
the NetBackup server. The default is 13782.

Note: If you change this port number, remember that it must be the same for all
NetBackup servers and clients that communicate with one another.
NetBackup request service This property specifies the port for the client to use when it sends requests to the
port (BPRD)
NetBackup request service (bprd process) on the NetBackup server. The default is
13720.

Note: If you change this port number, remember that it must be the same for all
NetBackup servers and clients that communicate with one another.

191

Configuring Host Properties

Network Settings Properties

Table 3-47

Network dialog box properties (continued)

Property

Description

Announce DHCP interval

This property specifies how many minutes the client waits before it announces that a
different IP address is to be used. The announcement occurs only if the specified time
period has elapsed and the address has changed since the last time the client
announced it.

Network Settings Properties

The Network Settings host properties apply to master servers, media servers,
indexing servers, and clients.
Figure 3-43

Network Settings dialog box

The Network Settings dialog box contains properties for Reverse Host Name
Lookup and IP Address Family Support.

192

Configuring Host Properties

Network Settings Properties

Reverse Host Name Lookup property

The domain name system (DNS) reverse host name lookup is used to determine
what host and domain name a given IP address indicates.
Some administrators cannot or do not want to configure the DNS server for reverse
host name lookup. For these environments, NetBackup offers the Reverse Host
Name Lookup property to allow, restrict, or prohibit reverse host name lookup.
Administrators can configure the Reverse Host Name Lookup property for each
host.
Table 3-48

Reverse Host Name Lookup property settings

Property

Description

Allowed setting

The Allowed property indicates that the host requires reverse host name lookup to
work to determine that the connection comes from a recognizable server.
By default, the host resolves the IP address of the connecting server to a host name
by performing a reverse lookup.
If the conversion of the IP address to host name fails, the connection fails.
Otherwise, it compares the host name to the list of known server host names. If the
comparison fails, the host rejects the server and the connection fails.

Restricted setting

The Restricted property indicates that the NetBackup host first attempts to perform
reverse host name lookup. If the NetBackup host successfully resolves the IP address
of the connecting server to a host name (reverse lookup is successful), it compares
the host name to the list of known server host names.
If the resolution of the IP address to a host name fails (reverse lookup fails), based on
the Restricted setting, the host converts the host names of the known server list to IP
addresses (using a forward lookup). The host compares the IP address of the connecting
server to the list of known server IP addresses.
If the comparison fails, the host rejects the connection from server and the connection
fails.

Prohibited setting

The Prohibited property indicates that the NetBackup host does not try reverse host
name lookup at all. The host resolves the host names of the known server list to IP
addresses using forward lookups.
The NetBackup host then compares the IP address of the connecting server to the list
of known server IP addresses.
If the comparison fails, the NetBackup host rejects the connection from the server and
the connection fails.

193

Configuring Host Properties

Port Ranges properties

Reverse Host Name Lookup changes outside of the

Administration Console
In some cases, a master server may not be able to view the host properties of a
media server or client in the NetBackup Administration Console. The NetBackup
customer's DNS reverse host name lookup configuration may be one possible
reason why the Host Properties may not be visible.
In this case, since changing the NetBackup Reverse Host Name Lookup host
property requires being able to view the Host Properties, youll need to use another
method to change it.
Configure the REVERSE_NAME_LOOKUP option by using the nbgetconfig and
nbsetconfig commands. The nbsetconfig command configures the option on
Windows and UNIX master servers and clients.
See Methods to set the NetBackup configuration options on page 67.
The REVERSE_NAME_LOOKUP entry uses the following format:
REVERSE_NAME_LOOKUP = ALLOWED | RESTRICTED | PROHIBITED

For example:
REVERSE_NAME_LOOKUP = PROHIBITED

The values of ALLOWED, RESTRICTED, and PROHIBITED represent the same meaning
as the values in the Network Settings host properties.

IP Address Family Support property

On hosts that use both IPv4 and IPv6 addresses, use the IP Address Family
Support property to indicate which address family to use:

IPv4 only (Default)

Both IPv4 and IPv6

While the IP Address Family Support property controls how hostnames are
resolved to IP addresses, the Preferred Network properties control how NetBackup
uses the addresses.

Port Ranges properties

Use the Port Ranges properties in the NetBackup Administration Console to
determine how hosts connect to one another. These properties apply to selected
master servers, media servers, indexing servers, and clients.

194

Configuring Host Properties

Port Ranges properties

Figure 3-44

Port Ranges dialog box

The Port Ranges dialog box contains the following properties.

Table 3-49

Port Ranges dialog box properties

Property

Description

Use random port

assignments

Specifies how the selected computer chooses a port when it communicates with
NetBackup on other computers. Enable this property to let NetBackup randomly select
ports from those that are free in the allowed range. For example, if the range is from
1023 through 5000, it chooses randomly from the numbers in this range.
If this property is not enabled, NetBackup chooses numbers sequentially, not randomly.
NetBackup starts with the highest number that is available in the allowed range. For
example, if the range is from 1023 through 5000, NetBackup chooses 5000. If 5000 is
in use, port 4999 is chosen.
This property is enabled by default.

Client port window

Lets the administrator define the range of non-reserved ports on the selected computer.
NetBackup can use any available port within this range as the source port when
communicating with NetBackup on another computer.

195

Configuring Host Properties

Port Ranges properties

Table 3-49

Port Ranges dialog box properties (continued)

Property

Description

Use OS selected non

reserved port

Lets the operating system determine which non-reserved port to use.

Client reserved port

window

This property is not used by NetBackup 7.0.1 and later unless one the following
conditions is true:

The connect options for the remote host specify that the daemon port be used.

Attempts to connect to ports 1556 and 13274 on the remote host fail, which causes
the daemon port to be used.

If either condition is true, then this setting defines the range of reserved ports to use
as the source port for the connection.
Beginning with NetBackup 7.0.1, connections to other daemon ports use only the Client
port window, not the Client reserved port window.
Server port window

This property specifies the range of non-reserved ports on which NetBackup processes
on this computer to accept connections from NetBackup on other computers when the
inbound connection is not to a well known port. This primarily applies to bpcd call-back
when vnetd is disabled in the connect options for the remote NetBackup server or
client and that host is configured for non-reserved ports.
This property also applies in the situation where a third-party protocol is used, such as
NDMP. It specifies the range of non-reserved ports on which this server accepts
NetBackup connections from other computers. The default range is 1024 through 5000.
Instead of indicating a range of ports, you can enable Use OS selected non reserved
port to let the operating system determine which non-reserved port to use.
This setting applies to the selected master or media server that connects to a server
or client that is configured to accept only non-reserved ports. The Accept connections
on non reserved ports property must be enabled in the Universal Settings dialog
box for hosts running NetBackup 7.0.1 and prior versions.
See Universal Settings properties on page 253.

Server reserved port

window

This entry specifies the range of local reserved ports on which this computer accepts
connections from NetBackup on other computers when the inbound connection is not
to a well known port. This primarily applies to bpcd call-back when vnetd is disabled
in the connect options for the remote NetBackup server or client.

Registered ports and dynamically-allocated ports

NetBackup communicates between computers by using a combination of registered
ports and dynamically-allocated ports.

196

Configuring Host Properties

Preferred Network properties

Registered ports
These ports are registered with the Internet Assigned Numbers Authority (IANA)
and are permanently assigned to specific NetBackup services. For example, the
port for the NetBackup client daemon (bpcd) is 13782.
The following system configuration file can be used to override the default port
numbers for each service:
On Windows: %systemroot%\system32\drivers\etc\services
On UNIX: /etc/services
Note: Symantec recommends that the port numbers that are associated with PBX
(1556 and 1557) not be changed.

Dynamically-allocated ports
These ports are assigned as needed, from configurable ranges in the Port Ranges
host properties for NetBackup servers and clients.
In addition to the range of numbers, you can specify whether NetBackup selects a
port number at random or starts at the top of the range and uses the first one
available.

Preferred Network properties

Use the Preferred Network properties in the NetBackup Administration Console
to specify to NetBackup which networks or interfaces to use for outgoing NetBackup
traffic from the selected hosts. These properties apply to currently selected master
servers, media servers, indexing servers, and clients.
The Preferred Network properties are useful in NetBackup environments that
include multihomed hoststhe hosts that are connected to two or more networks,
or hosts that have two or more network addresses. The properties are especially
helpful to administrators who must configure an environment that includes both
Internet Protocol version 6 (IPv6) and IPv4 address families.
The Preferred Network properties compare to the Use specified network interface
property in the Universal Settings properties. However, the Use specified network
interface property can be used to specify only a single interface for NetBackup to
use for outbound calls. The Preferred Network properties were introduced so that
administrators can give more elaborate and constrictive instructions that apply to
multiple individual networks, or a range of networks. For example, an administrator
can configure a host to use any network except one.

197

Configuring Host Properties

Preferred Network properties

Note: Do not inadvertently configure hosts so that they cannot communicate with
any other host. Use the bptestnetconn utility to determine whether the hosts can
communicate as you intend.
See bptestnetconn utility to display Preferred Network information on page 207.
Figure 3-45

Preferred Network dialog box

The Preferred Network dialog box contains a list of networks and the directive that
has been configured for each.

198

Configuring Host Properties

Preferred Network properties

Table 3-50

Preferred Network dialog box properties

Property

Description

List of network
specifications for
NetBackup
communications

The list of preferred networks contains the following information:

Ordering arrows

The Target column lists the networks (or hostnames or IP addresses) that have been
given specific directives. If a network is not specifically listed as a target, or if a range
of addresses does not include the target, NetBackup considers the target to be available
for selection.
Note that if the same network considerations apply for all of the hosts, the list of directives
can be identical across all hosts in the NetBackup environment. If a directive contains
an address that does not apply to a particular host, that host ignores it. For example,
an IPv4-only host ignores IPv6 directives, and IPv6-only hosts ignore IPv4 directives.
This lets the administrator use the same Preferred Network configurations for all the
hosts in the NetBackup environment.
The Specified as column indicates the directive for the network: Match, Prohibited,
or Only.
The Source column lists source binding information to use to filter addresses. The
Source property is an optional configuration property.

Select a network in the list, then click the up or down arrow to change the order of the
network in the list. The order can affect which network NetBackup selects.
See Order of directive processing in the Preferred Network properties on page 206.

Add

Click Add to add a network to the Preferred Network properties. The directive for the
network is configured in the Add Preferred Network Settings dialog box.
See Table 3-51 on page 200.

Add to all

The Add to all button is active when multiple servers are selected.

Change

Select a network in the list, then click Change to change the Preferred Network properties.
The directive is changed in the Change Preferred Network Settings dialog box.
See Add or Change Preferred Network Settings dialog box on page 199.

Remove

Select a network in the list, then click Remove to remove the network from the list of
preferred networks.

Add or Change Preferred Network Settings dialog box

The Add Preferred Network Settings dialog box contains the following properties.

199

Configuring Host Properties

Preferred Network properties

Table 3-51

Add or Change Preferred Network Settings dialog box properties

Property

Description

Target

Enter a network address or a hostname:

If an address is specified as the network, it is usually considered a remote or target address.

NetBackup recognizes the following wildcard entries as addresses:
0.0.0.0

Matches any IPv4 address.

0::0

Matches any IPv6 address.

0/0

Matches the address of any family.

If a hostname is specified as the network, then the address that is used is the first returned
by the DNS resolver.

Note: Do not use the following malformed entries as wildcards: 0/32, 0/64, or 0/128. The left side
of the slash must be a legitimate IP address. However, 0/0 may be used, as listed.
Match

The Match directive indicates that the specified network, address, or hostname is preferred for
communication with the selected host.
The Match directive does not reject other networks, addresses, or hostnames from being selected,
even if they do not match. (The Only directive rejects unsuitable targets if they do not match.)
The Match directive is useful following a Prohibited or a Only directive. When used with other
directives, Match indicates to NetBackup to stop rule processing because a suitable match has
been found.
The Match directive can be used with the Source property to indicate source binding.

Prohibited

Use the Prohibited directive to exclude or prevent the specified network, address, or hostname
from being considered. In a list of DNS addresses, addresses in these networks are avoided.

Only

The Only directive indicates that the specified network, address, or hostname that is used for
communication with the selected host must be in the specified network.
Use the Only directive to prevent any network from being considered other than those specified
as Only.
This directive replaces the REQUIRED_NETWORK configuration option.
The Only directive can be used with the Source property to indicate source binding.

200

Configuring Host Properties

Preferred Network properties

Table 3-51

Add or Change Preferred Network Settings dialog box properties

(continued)

Property

Description

Source

Use this property with the Match or the Only directives to describe the local hostname, IP
addresses, or networks that may be used for source binding.
NetBackup matches the desired source interfaces, (backup networks, for example) with the target
addresses described by the Source property.
The corresponding configuration option for this property is PREFERRED_NETWORK. This property
replaces the REQUIRED_INTERFACE entry.
See PREFERRED_NETWORK option for NetBackup servers on page 306.

How NetBackup uses the directives to determine which network to

use
Each host has an internal table of preferred network rules that NetBackup consults
before it selects a network interface to use for communication with another host.
The table includes every interface-IP address combination available to the selected
host. Based on the Preferred NetBackup directives, the table indicates to
NetBackup whether or not the host is allowed to use a given network.
This topic uses the example of two multihomed servers (Server_A and Server_B)
as shown in Figure 3-46. Server A is considering which addresses it can use to
access Server_B, given the Preferred Network directives configured on Server_A.
When Preferred Network directives are used to place restrictions on targets, they
are added from the perspective of the server making the connection. The directives
on Server_A affect its preferences as to which Server_B addresses it can use.

201

Configuring Host Properties

Preferred Network properties

Figure 3-46

Multihomed servers example

Server_A
Directives on Server_A
indicate what interfaces
it can use to access
Server_B

Backup interface
2001:db8:0:11d::1efc

Production interface
10.81.73.147
2001:db8:0:1f0::1efc

Backup interface
2001:db8:0:11e::1efc
2001:db8:0:11c::1efc

Server_B

Backup interface
10.96.73.253

Figure 3-47 shows a table for Server_B. Server_B has multiple network interfaces,
some of which have multiple IP addresses. In the table, yes indicates that NetBackup
can use the network-IP combination as a source. In this example, no directives
have been created for the host. Since no networks are listed in the Preferred
Network properties, any network-IP combinations can be used for communication.
Note: The following topic shows the bptestnetconn output for this example
configuration:
See Figure 3-54 on page 208.

202

Configuring Host Properties

Preferred Network properties

Figure 3-47

From Server_A's perspective: Available IP addresses on Server_B

when no directives are indicated on Server_A

Network interfaces

IP addresses
IPv4

IPv6

2001:0db8:0:1f0::1efc

---

Yes

10.80.73.147

Yes

---

2001:0db8:0:11c::1efc

---

Yes

2001:0db8:0:11d::1efc

---

Yes

2001:0db8:0:11e::1efc

---

Yes

10.96.73.253

Yes

---

Figure 3-48 shows a table for the same host (Server_B). Now, the Preferred
Network properties are configured so that all IPv4 addresses are excluded from
selection consideration by NetBackup. All NetBackup traffic is to use only IPv6
addresses.
Figure 3-48

From Server_A's perspective: Available IP addresses on Server_B

when directives to use IPv6 addresses only are indicated on Server_A

Network interfaces

IP addresses
IPv4

IPv6

2001:0db8:0:1f0::1efc

---

Yes

10.80.73.147

No

---

2001:0db8:0:11c::1efc

---

Yes

2001:0db8:0:11d::1efc

---

Yes

2001:0db8:0:11e::1efc

---

Yes

10.96.73.253

No

---

The following topics describe various configurations:

See Configurations to use IPv6 networks on page 204.

See Configurations to use IPv4 networks on page 205.

See Configuration to prohibit using a specified address on page 209.

See Configuration that uses the same specification for both the network and
the interfaceless constrictive on page 209.

203

Configuring Host Properties

Preferred Network properties

See Configuration that uses the same specification for both the network and
the interfacemore constrictive on page 210.

See Configuration that limits the addresses, but allows any interfaces
on page 210.

Configurations to use IPv6 networks

The following Preferred Network configurations instruct NetBackup to use only
IPv6 addresses as targets in outbound calls for the currently selected hosts. The
configurations satisfy a topology where all backup traffic uses an IPv6 network and
other traffic uses other networks.
One configuration uses the Prohibited directive (Figure 3-49) and one configuration
uses the Match directive (Figure 3-50).
The more efficient method to specify one address family, (IPv6, in this case), is to
prohibit IPv4. The behavior of the Match directive is not as exclusive as Prohibited.
In this case, Match may not necessarily exclude other address families.
Figure 3-49 uses the Prohibited directive with a wildcard to indicate to NetBackup
to not consider using any IPv4 addresses. In this situation, NetBackup must use
an IPv6 address.
Note: The default configuration is for NetBackup to use only IPv4 addresses.
Creating a directive that prohibits all IPv4 addresses renders the server mute unless
you have IPv6 addresses and have them enabled.
See IP Address Family Support property on page 194.
Figure 3-49

Prohibit IPv4 addresses as targets

Figure 3-50 uses the Match directive with a wildcard to indicate to NetBackup to
consider only IPv6 addresses. In this case, NetBackup tries to use an IPv6 address,
but may consider IPv4 addresses if necessary.

204

Configuring Host Properties

Preferred Network properties

Figure 3-50

Match IPv6 addresses as targets

Figure 3-51 shows another configuration that allows NetBackup to choose from
multiple IPv6 networks.
Given the multihomed example configuration, the directive indicates the following:

Four IPv6 networks, from fec0:0:0:fe04 to fec0:0:0:fe07, are described as

targets.

For all addresses in these networks, a source binding address that is derived
from the IP addresses of host name host_fred is used.

See How NetBackup uses the directives to determine which network to use
on page 201.
Figure 3-51

Indicating a range of IPv6 networks

Configurations to use IPv4 networks

The following Preferred Network configurations instruct NetBackup to use only
IPv4 addresses as targets in outbound calls for the currently selected hosts. The
configurations satisfy a topology where all backup traffic uses an IPv4 network and
other traffic uses other networks.
One configuration uses the Prohibited directive (Figure 3-52) and one configuration
uses the Match directive (Figure 3-53).
The more efficient method to specify one address family, (IPv4, in this case), is to
prohibit IPv6. The behavior of the Match directive is not as exclusive as Prohibited.
In this case, Match may not necessarily exclude other address families.

205

Configuring Host Properties

Preferred Network properties

Figure 3-52 uses the Prohibited directive with a wildcard to indicate to NetBackup
to not consider using any IPv6 addresses. In this situation, NetBackup must use
an IPv4 address.
Figure 3-52

Prohibit IPv6 addresses as targets

Figure 3-53 uses the Match directive with a wildcard to indicate to NetBackup to
consider only IPv4 addresses. In this case, NetBackup tries to use an IPv4 address,
but may consider IPv6 addresses if necessary.
Figure 3-53

Match IPv4 addresses as targets

Order of directive processing in the Preferred Network properties

NetBackup sorts all directives into decreasing order by subnet size so that the more
specific network specifications, such as complete hostnames or IP addresses,
match first. (For example, a /24 subnet matches before a /16 subnet.) In this way,
NetBackup can honor host-specific overrides.
If NetBackup considers the directives of multiple networks to be equal in specificity
(a tie), NetBackup looks at the order in which the networks are listed.
See Order of directives can affect processing on page 207.
NetBackup processes each resolved address in the network list according to specific
rules. Directives that contain addresses that do not apply to the host are ignored.
Table 3-52 describes how NetBackup determines whether an address can be used
for communication.

206

Configuring Host Properties

Preferred Network properties

Table 3-52

Order of directive processing

Step

NetBackup considers the target

If the target is not a match for the directive, and

if the directive is an Only directive...

Target is selected or processing continues

...then the target is treated as Prohibited, and
processing stops for that target.
NetBackup considers the next target.

If the target is a match for the directive, and

if the directive is a Prohibited directive...

...then the target is treated as Prohibited and

processing stops for that target.
NetBackup considers the next target.

If the target is not a match...

...then the processing continues.

NetBackup considers the next directive in the list.

If the target is a match...

...then the directive is either Only or Match and further

directive processing stops.
An Only match is treated like a Match in terms of
source binding computation. If no rules ever match,
then the target is allowed, and no source binding is
enforced.

Order of directives can affect processing

The order of the networks in the list can affect which network NetBackup selects
for communication for the selected hosts.
The strongest filters are Prohibited and Only.
Use the up or down arrows to the right of the list to change the order of the networks.

bptestnetconn utility to display Preferred Network information

The bptestnetconn utility is available to administrators to test and analyze host
connections. Use the preferred network option (--prefnet) to display information
about the preferred network configuration along with the forward lookup information
of a host on the server list.
The bptestnetconn command is described in the NetBackup Commands Reference
Guide.
Figure 3-54 shows the bptestnetconn output when run on Server_A, for Server_B.
That is, bptestnetconn is run from Server_A's perspective. Based on the directives
configured on Server_A, for Server_B, bptestnetconn shows the available IP
addresses on Server_B. In this example, no directives are configured on Server_A.

207

Configuring Host Properties

Preferred Network properties

Figure 3-54

bptestnetconn for Server_B with no directives listed

[root@Server_A netbackup]# bptestnetconn -f --prefnet -H Server_B

--------------------------------------------------------------------FL: Server_B -> 10.81.73.147
:
11 ms SRC: ANY
FL: Server_B -> 10.96.73.253
:
11 ms SRC: ANY
FL: Server_B -> 2001:db8:0:11d::1efc
:
11 ms SRC: ANY
FL: Server_B -> 2001:db8:0:11e::1efc
:
11 ms SRC: ANY
FL: Server_B -> 2001:d8b:0:1f0::1efc
:
11 ms SRC: ANY
FL: Server_B -> 2001:db8:0:11c::1efc
:
11 ms SRC: ANY
--------------------------------------------------------------------Total elapsed time: 0 sec
Host for which lookup
is performed

List of networks available to

Server_B

Any source is available to

use for a connection

The following directive is added to the Preferred Networks properties on Server_B:

In the configuration file the directive appears as follows:

PREFERRED_NETWORK = 2001:0db8:0:11c::/62 ONLY

This directive provides NetBackup with the information to filter the addresses and
choose to communicate with only those that match the :11c, :11d, :11e, and :11f
networks. The addresses that do not match the Only directive are prohibited, as
shown in the bptestnetconn output.
See PREFERRED_NETWORK option for NetBackup servers on page 306.
Figure 3-55 shows the bptestnetconn output for Server_B, given this directive.

208

Configuring Host Properties

Preferred Network properties

Figure 3-55

bptestnetconn for Server_B with directive

[root@Server_A netbackup]# bptestnetconn -f --prefnet -H Server_B

--------------------------------------------------------------------FL: Server_B -> 10.81.73.147
:
11 ms TGT PROHIBITED
FL: Server_B -> 10.96.73.253
:
11 ms TGT PROHIBITED
FL: Server_B -> 2001:db8:0:11d::1efc
:
11 ms SRC: ANY
FL: Server_B -> 2001:db8:0:11e::1efc
:
11 ms SRC: ANY
FL: Server_B -> 2001:d8b:0:1f0::1efc
:
11 ms TGT PROHIBITED
FL: Server_B -> 2001:db8:0:11c::1efc
:
11 ms SRC: ANY
--------------------------------------------------------------------Total elapsed time: 0 sec
List of networks available to
Server_B

Directives make some targets

unavailable to Server_B

Configuration to prohibit using a specified address

Figure 3-56 shows a configuration that prohibits NetBackup from using the specified
address.
Figure 3-56

Prohibited target example

Configuration that uses the same specification for both the network
and the interfaceless constrictive
Figure 3-57 shows a configuration that uses the same specification for both the
network and the interface.
For all target addresses in the specified network, a source binding in the same
network is selected. This directive is considered generic since the identical directive
applies to all NetBackup hosts on the network. The closest preferred source address
that matches a remote address is used for source binding.
A production network outside this range can then be Prohibited, thereby preferring
these addresses from both a remote and source binding perspective. Additional
Match directives may be used to indicate additional backup networks that are
allowed.

209

Configuring Host Properties

Preferred Network properties

Figure 3-57

Match network selection with the source

Configuration that uses the same specification for both the network
and the interfacemore constrictive
Figure 3-58 also uses the same specification for both target and source binding,
however this example is more restrictive. With the Only property specified, this
configuration does not allow multiple backup networks to be specified.
Figure 3-58

Only network selection with the same source binding address

A host with the Only directive configured considers only those target addresses in
the 192.168.100.0 subnet. Additionally, source binding to the local interface must
be done on the 192.168.100.0 subnet.
On hosts that have a 192.168.100.0 interface but no :1b0 interface, source binding
to the :1f0 interface is the default of the operating system.

Configuration that limits the addresses, but allows any interfaces

Figure 3-59 shows a configuration that allows only the addresses that start with the
specified prefix to be considered. No source binding is specified, so any interface
may be used.

210

Configuring Host Properties

Resilient Network properties

Figure 3-59

Limiting the addresses, without any source binding

Resilient Network properties

The Resilient Network properties appear for the master server, for media servers,
and for clients. For media servers and clients, the Resilient Network properties
are read only. When a job runs, the master server updates the media server and
the client with the current properties.
The Resilient Network properties let you configure NetBackup to use resilient
network connections for backups and restores. A resilient connection allows backup
and restore traffic between a client and a NetBackup media server to function
effectively in high-latency, low-bandwidth networks such as WANs. The data travels
across a wide area network (WAN) to media servers in a central datacenter.
NetBackup monitors the socket connections between the remote client and the
NetBackup media server. If possible, NetBackup re-establishes dropped connections
and resynchronizes the data stream. NetBackup also overcomes latency issues to
maintain an unbroken data stream. A resilient connection can survive network
interruptions of up to 80 seconds. A resilient connection may survive interruptions
longer than 80 seconds.
The NetBackup Remote Network Transport Service manages the connection
between the computers. The Remote Network Transport Service runs on the master
server, the client, and the media server that processes the backup or restore job.
If the connection is interrupted or fails, the services attempt to re-establish a
connection and synchronize the data.
NetBackup protects only the network socket connections that the NetBackup Remote
Network Transport Service (nbrntd) creates. Examples of the connections that are
not supported are:

Clients that back up their own data (deduplication clients and SAN clients)

Granular Recovery for Exchange or SharePoint

NetBackup nbfsd process.

211

Configuring Host Properties

Resilient Network properties

NetBackup protects connections only after they are established. If NetBackup cannot
create a connection because of network problems, there is nothing to protect.
Resilient connections apply between clients and NetBackup media servers, which
includes master servers when they function as media servers. Resilient connections
do not apply to master servers or media servers if they function as clients and back
up data to a media server.
Resilient connections can apply to all of the clients or to a subset of clients.
Note: If a client is in a different subdomain than the server, add the fully qualified
domain name of the server to the clients hosts file. For example,
india.symantecs.org is a different subdomain than china.symantecs.org.
When a backup or restore job for a client starts, NetBackup searches the Resilient
Network list from top to bottom looking for the client. If NetBackup finds the client,
NetBackup updates the resilient network setting of the client and the media server
that runs the job. NetBackup then uses a resilient connection.
Figure 3-60

Master server Resilient Network host properties

212

Configuring Host Properties

Resilient Network properties

See About the Services or Daemons tab on page 1026.

Table 3-53 describes the Resilient Network properties.
Table 3-53

Resilient Network dialog box properties

Property

Description

Host Name or IP Address

The Host Name or IP Address of the host. The address can

also be a range of IP addresses so you can configure more
than one client at once. You can mix IPv4 addresses and
ranges with IPv6 addresses and subnets.
If you specify the host by name, Symantec recommends that
you use the fully qualified domain name.
Use the arrow buttons on the right side of the pane to move
up or move down an item in the list of resilient networks.

Resiliency

Resiliency is either ON or OFF.

Note: The order is significant for the items in the list of resilient networks. If a client
is in the list more than once, the first match determines its resilient connection
status. For example, suppose you add a client and specify the client IP address
and specify On for Resiliency. Suppose also that you add a range of IP addresses
as Off, and the client IP address is within that range. If the client IP address appears
before the address range, the client connection is resilient. Conversely, if the IP
range appears first, the client connection is not resilient.
The resilient status of each client also appears as follows:

In the NetBackup Administration Console, select NetBackup Management

> Policies in the left pane and then select a policy. In the right pane, a
Resiliency column shows the status for each client in the policy.

In the NetBackup Administration Console, select NetBackup Management

> Host Properties > Clients in the left pane. In the right pane, a Resiliency
column shows the status for each client.

Other NetBackup properties control the order in which NetBackup uses network
addresses.
See Preferred Network properties on page 197.
The NetBackup resilient connections use the SOCKS protocol version 5.
Resilient connection traffic is not encrypted. Symantec recommends that you encrypt
your backups. For deduplication backups, use the deduplication-based encryption.
For other backups, use policy-based encryption.

213

Configuring Host Properties

Resilient Network properties

Resilient connections apply to backup connections. Therefore, no additional network

ports or firewall ports must be opened.
Note: If multiple backup streams run concurrently, the Remote Network Transport
Service writes a large amount of information to the log files. In such a scenario,
Symantec recommends that you set the logging level for the Remote Network
Transport Service to 2 or less. Instructions to configure unified logs are in a different
guide.
See the NetBackup Troubleshooting Guide.

Resilient connection resource usage

Resilient connections consume more resources than regular connections, as follows:

More socket connections are required per data stream. Three socket connections
are required to accommodate the Remote Network Transport Service that runs
on both the media server and the client. Only one socket connection is required
for a non-resilient connection.

More sockets are open on media servers and clients. Three open sockets are
required rather than one for a non-resilient connection. The increased number
of open sockets may cause issues on busy media servers.

More processes run on media servers and clients. Usually, only one more
process per host runs even if multiple connections exist.

The processing that is required to maintain a resilient connection may reduce

performance slightly.

Specifying resilient connections

Use the following procedure to specify resilient connections for NetBackup clients.
See Resilient Network properties on page 211.
Alternatively, you can use the resilient_clients script to specify resilient
connections for clients:

Windows:
install_path\Veritas\NetBackup\bin\admincmd\resilient_clients

UNIX: /usr/openv/netbackup/bin/admincmd/resilient_clients

214

Configuring Host Properties

Resilient Network properties

To specify resilient connections

In the NetBackup Administration Console, expand NetBackup Management

> Host Properties > Master Servers in the left pane.

In the right pane, select the master server on which to specify properties.

On the Actions menu, click Properties.

In the properties dialog box left pane, select Resilient Network.

In the Resilient Network dialog box, use the following buttons to manage
resiliency for clients:
Add

To add resilient settings

1

Click Add.
The Add Resilient Network Settings dialog box appears

Enter a client host name, an IP address, or an address range.

If you specify the client host by name, Symantec recommends that
you use the fully qualified domain name.
For address ranges, use Classless Inter-Domain Routing (CIDR)
notation (for example, 192.168.100.0/24 or fd00::/8).

Add To All

Ensure that the Resiliency On option is selected.

Click Add.

Repeat until you have finished entering clients or address ranges.

When you finish adding network settings, click Close.

If you select multiple hosts in the NetBackup Administration Console,

the entries in the Resilient Network list may appear in different colors,
as follows:

The entries that appear in black type are configured on all of the
hosts.
The entries that appear in gray type are configured on some of the
hosts only.

For the entries that are configured on some of the hosts only, you can
add them to all of the hosts. To do so, select them and click Add To All.

215

Configuring Host Properties

Resource Limit properties

Change

To change resilient settings

1

Select the client host name, the IP address, or the address range.

Click Change.
The Change Resilient Network Settings dialog box appears

Remove

Select the desired Resiliency setting.

Click OK.

Remove the select host or address range as follows

1

Select the client host name, the IP address, or the address range.

Click Remove.
The client is removed immediately; a confirmation dialog box does
not appear.

Move an item in the list of items

1

Select the client host name, the IP address, or the address range.

Click the appropriate button to move up the item or move down the
item.
The order of the items in the list is significant.
See Resilient Network properties on page 211.

After specifying resilient connections, click OK.

The settings are propagated to the affected hosts through normal NetBackup
inter-host communication, which can take up to 15 minutes.

If you want to begin a backup immediately, restart the NetBackup services on

the master server.

Resource Limit properties

The Resource Limit properties in the NetBackup Administration Console control
the number of simultaneous backups that can be performed on a VMware resource
type. These settings apply to all policies for the currently selected master server.
Note: The Resource Limit dialog applies only to policies that use automatic selection
of virtual machines (the policy's Query Builder). If you select virtual machines
manually on the Browse for Virtual Machines dialog box, the Resource Limit
properties have no effect.

216

Configuring Host Properties

Resource Limit properties

Figure 3-61

Resource Limit dialog box

The Resource Limit dialog box contains the following properties.

Table 3-54

Resource Limit dialog box properties

Property

Description

vCenter

The maximum number of simultaneous backups per vCenter

server.

snapshot

The maximum number of simultaneous snapshot operations

(create or delete) per vCenter.

Cluster

The maximum number of simultaneous backups per VMware

cluster.

ESXserver

The maximum number of simultaneous backups per ESX server.

VMXDatastore

The maximum number of simultaneous backups per VMX

datastore.

Datastore

The maximum number of simultaneous backups per Datastore.

217

Configuring Host Properties

Restore Failover properties

Table 3-54

Resource Limit dialog box properties (continued)

Property

Description

DatastoreFolder

The maximum number of simultaneous backups per datastore

folder.

DatastoreType

The maximum number of simultaneous backups per datastore

type.

VMXDatastoreNFSHost The maximum number of simultaneous backups per NFS host of

the VMX datastore.
DatastoreNFSHost

The maximum number of simultaneous backups per NFS host of

the datastore.

DatastoreCluster

The maximum number of simultaneous backups per datastore

cluster.

For example, a Resource Limit of four for Datastore means that NetBackup policies
can perform no more than four simultaneous backups on any particular datastore.

Restore Failover properties

The Restore Failover properties in the NetBackup Administration Console
control how NetBackup performs automatic failover to a NetBackup media server.
A failover server may be necessary if the regular media server is temporarily
inaccessible to perform a restore operation. The automatic failover does not require
administrator intervention. By default, NetBackup does not perform automatic
failover. These properties apply to currently selected master servers.

218

Configuring Host Properties

Restore Failover properties

Figure 3-62

Restore Failover dialog box

The Restore Failover dialog box contains the following properties:

Table 3-55
Property

Description

Media server

Displays the NetBackup media servers that have failover protection for
restores.

Failover restore
server

Displays the servers that provide the failover protection. NetBackup

searches from top to bottom in the column until it finds another server
that can perform the restore.

A NetBackup media server can appear only once in the Media server column but
can be a failover server for multiple other media servers. The protected server and
the failover server must both be in the same master and media server cluster.
The following situations describe examples of when to use the restore failover
capability:

219

Configuring Host Properties

Restore Failover properties

Two or more media servers share a robot and each has connected drives. When
a restore is requested, one of the servers is temporarily inaccessible.

Two or more media servers have stand alone drives of the same type. When a
restore is requested, one of the servers is temporarily inaccessible.

In these instances, inaccessible means that the connection between bprd on the
master server and bptm on the media server (through bpcd) fails.
Possible reasons for the failure are as follows:

The media server is down.

The media server is up but bpcd does not respond. (For example, if the
connection is refused or access is denied.)

The media server is up and bpcd is running, but bptm has problems. (For
example, bptm cannot find the required tape.)

Assigning an alternate media server as a failover restore server

You can assign another media server to act as a failover restore server for your
media server. If your media server is unavailable during a restore, the failover
restore server takes its place.
To assign an alternate media server as a failover restore server

In the NetBackup Administration Console, in the left panel, expand

NetBackup Management > Host Properties > Master Servers.

In the right pane, double-click on the master server you want to modify.

In the properties dialog box, in the left pane, click Restore Failover.

Click Add.

In the Media server field, specify the media server for failover protection.

In the Failover restore servers field, specify the media servers to try if the
server that is designated in the Media server field is unavailable. Separate
the names of multiple servers with a single space.

Click Add. The dialog box remains open for another entry.

Click Close.

From the Restore Failover dialog box, click Apply to accept the changes.

Before the change takes effect, you must stop and restart the NetBackup Request
daemon on the master server where the configuration was changed.
See About enabling automatic failover to an alternate server on page 1154.

220

Configuring Host Properties

Retention Periods properties

Retention Periods properties

Use the Retention Periods properties in the NetBackup Administraton Console
to define a duration for each retention level. You can select from 25 retention levels.
In a policy, the retention period determines how long NetBackup retains the backups
or the archives that are created according to the schedule. These properties apply
to selected master servers.
Figure 3-63

Retention Periods dialog box

By default, NetBackup stores each backup on a volume that already contains

backups at the same retention level. However, NetBackup does not check the
retention period that is defined for that level. When the retention period for a level
is redefined, some backups that share the same volume may have different retention
periods.
For example, if the retention level 3 is changed from one month to six months,
NetBackup stores future level 3 backups on the same volumes. That is, the backups
are placed on the volumes with the level 3 backups that have a retention period of
one month.

221

Configuring Host Properties

Retention Periods properties

No problem exists if the new and the old retention periods are of similar values.
However, before a major change is made to a retention period, suspend the volumes
that were previously used for that retention level.
See Determining retention periods for volumes on page 224.
See Suspending or unsuspending volumes on page 494.
The Retention Periods dialog box contains the following properties.
Table 3-56

Retention Periods dialog box properties

Property

Description

Value

Assigns a number to the retention level setting.

Units

Specifies the units of time for the retention period. The list includes hours as the smallest
unit of granularity and the special units, Infinite, and Expires immediately.

Retention Level

The retention level number (0 through 24).

Retention Period

A list of the current definitions for the 25 possible levels of retention. By default, levels
9 through 24 are set to infinite. Retention level 9 is the only level that cannot be changed
and remains at infinite.
See Retention Periods with end dates beyond 2038, excluding Infinity on page 224.
With the default, there is no difference between a retention level of 12 and a retention
level of 20, for example.
The Schedule Count column indicates how many schedules currently use each level.
If the retention period is changed for a level, it affects all schedules that use that level.
The Changes Pending column uses an asterisk (*) to indicate that the period has
been changed and not applied. NetBackup does not change the actual configuration
until the administrator accepts or applies the changes.

Schedule Count

Lists the number of schedules that use the currently selected retention level.

Schedules using this

retention level

Displays a list of the current policy names and schedule names that use the retention
level.

Impact Report

Displays a summary of how changes affect existing schedules. The list displays all
schedules in which the retention period is shorter than the frequency period.

Changing a retention period

Use the following procedure to change a retention period.

222

Configuring Host Properties

Retention Periods properties

To change a retention period

In the NetBackup Administration Console, in the left pane, expand

NetBackup Management > Host Properties > Master Servers.

In the right pane, double-click on the master server you want to modify.

In the properties dialog box, in the left pane, click Retention Periods.

Select the retention level to change.

By default, levels 9 through 24 are set to infinite. If the levels are left at the
default, there is no difference between a retention level of 12 and a retention
level of 20. Level 9 cannot be changed and remains at a setting of infinite.
See Retention Periods with end dates beyond 2038, excluding Infinity
on page 224.
On Windows: The policy impact list now displays the names of all schedules
that use the selected retention level. It also lists the policy to which each
schedule belongs.
On UNIX: The dialog box displays the names of all schedules that use the
selected retention level as well as the policy to which each schedule belongs.

Type the new retention period in the Value box.

From the Units drop-down list, select a unit of measure (days, weeks, months,
years, Infinite, or Expires immediately).
After you change the value or unit of measure, an asterisk (*) appears in the
Changes Pending column to indicate that the period was changed. NetBackup
does not change the actual configuration until the administrator accepts or
applies the changes.

Click Impact Report.

The policy impact list displays the policies and the schedule names where the
new retention period is less than the frequency period. To prevent a potential
gap in backup coverage, redefine the retention period for the schedules or
change the retention or frequency for the schedule.

Do one of the following:

To discard your changes, click Cancel.

To save your changes and leave the dialog box open to make further
changes, click Apply.

To save your changes and close the dialog box, click OK.

223

Configuring Host Properties

Scalable Storage properties

Determining retention periods for volumes

Use the following procedure to determine retention periods for volumes.
To determine retention periods for volumes

In the NetBackup Administration Console, in the left pane, expand Media

and Device Management > Media

In the right pane, find the volume on the list and examine the value in the
Retention Period column.

To see all volumes that have the same retention period, click the Retention Period
column header to sort the volumes by retention period. This column heading is
hidden by default.

Retention Periods with end dates beyond 2038, excluding Infinity

Due to UNIX epoch time and the year 2038 problem, any retention end date that
exceeds January 19, 2038 is automatically set to expire on January 19, 2038,
regardless of whether the expiration end date is reached
This issue does not apply to retention levels for which the retention period is set to
Infinity. NetBackup never expires media with a retention set to Infinity unless
instructed to do so by the NetBackup administrator.

Scalable Storage properties

The Scalable Storage properties contains the Cloud Settings properties tab. The
Scalable Storage properties appear only if a cloud storage server is configured.
The Scalable Storage properties apply to currently selected media servers.
See Cloud Settings tab of the Scalable Storage properties on page 224.

Cloud Settings tab of the Scalable Storage properties

The Cloud Settings properties contain information about encryption, metering,
bandwidth throttling, and network connections between the NetBackup hosts and
your cloud storage provider.
The Cloud Settings tab appears if the cloud storage service is active on the selected
media server.

224

Configuring Host Properties

Scalable Storage properties

Figure 3-64

Scalable Storage Cloud Settings host properties

Table 3-57 describes the properties.

Table 3-57

Cloud storage host properties

Property

Description

Key Management Server

(KMS) Name

If you configured the NetBackup Key Management Service (KMS), the name of the
KMS server.

Metering Interval

Determines how often NetBackup gathers connection information for reporting purposes.
NetBackup OpsCenter uses the information that is collected to create reports. The
value is set in seconds. The default setting is 300 seconds (5 minutes). If you set this
value to zero, metering is disabled.

Total Available Bandwidth

Use this value to specify the speed of your connection to the cloud. The value is
specified in kilobytes per second. The default value is 102400 KB/sec.

Sampling interval

The time, in seconds, between measurements of bandwidth usage. The larger this
value, the less often NetBackup checks to determine the bandwidth in use.

225

Configuring Host Properties

Scalable Storage properties

Table 3-57

Cloud storage host properties (continued)

Property

Description

Advanced Settings

Click Advanced Settings to specify additional settings for throttling.

See Configuring advanced bandwidth throttling settings on page 226.
See Advanced bandwidth throttling settings on page 227.

Maximum connections

The default maximum number of concurrent connections that the media server can
open to the cloud storage server. If the maximum number of connections is configured
for your cloud storage provider, NetBackup uses that value instead of this default.
This value applies to the media server not to the cloud storage server. If you have more
than one media server that can connect to the cloud storage server, each media server
can have a different value. Therefore, to determine the total number of connections to
the cloud storage server, add the values from each media server.
If NetBackup is configured to allow more jobs than the number of connections,
NetBackup fails any jobs that start after the number of maximum connections is reached.
NetBackup retries the failed jobs. If a connection is available when NetBackup retries
a failed job, the job does not fail because of a lack of connections. Jobs include both
backup and restore jobs.
You can configure job limits per backup policy and per storage unit.
See Limit jobs per policy (policy attribute) on page 684.
See Maximum concurrent jobs storage unit setting on page 555.

Note: NetBackup must account for many factors when it starts jobs: the number of
concurrent jobs, the number of connections per media server, the number of media
servers, and the job load-balancing logic. Therefore, NetBackup may not fail jobs
exactly at the maximum number of connections. NetBackup may fail a job when the
connection number is slightly less than the maximum, exactly the maximum, or slightly
more than the maximum.
In practice, you should not need to set this value higher than 100.

For more information about NetBackup cloud storage, see the NetBackup Cloud
Administrator's Guide.

Configuring advanced bandwidth throttling settings

Advanced bandwidth throttling settings let you control various aspects of the
connection between the NetBackup hosts and your cloud storage provider.
The total bandwidth and the bandwidth sampling interval are configured on the
Cloud Settings tab of the Scalable Storage host properties screen.
See Scalable Storage properties on page 224.

226

Configuring Host Properties

Scalable Storage properties

To configure advanced bandwidth throttling settings

In the NetBackup Administration Console, expand NetBackup Management

> Host Properties > Media Servers in the left pane.

In the right pane, select the host on which to specify properties.

Click Actions > Properties.

In the properties dialog box left pane, select Scalable Storage.

In the right pane, click Advanced Settings. The Advanced Throttling

Configuration dialog box appears.
The following is an example of the dialog box:

Configure the settings and then click OK.

See Advanced bandwidth throttling settings on page 227.

Advanced bandwidth throttling settings

The following table describes the advanced bandwidth throttling settings.

227

Configuring Host Properties

Scalable Storage properties

Table 3-58

Advanced Throttling Configuration settings

Property

Description

Read Bandwidth

Use this field to specify the percentage of total bandwidth that read
operations can use. Specify a value between 0 and 100. If you
enter an incorrect value, an error is generated.
If there is insufficient bandwidth to transmit the specified amount
of data within a few minutes, restore or replication failures may
occur due to timeouts.
Consider the total load of simultaneous jobs on multiple media
servers when you calculate the required bandwidth.
Default value: 100
Possible values: 0 to 100

Write Bandwidth

Use this field to specify the percentage of total bandwidth that write
operations can use. Specify a value between 0 and 100. If you
enter an incorrect value, an error is generated.
If there is insufficient bandwidth to transmit the specified amount
of data within a few minutes, backup failures may occur due to
timeouts.
Consider the total load of simultaneous jobs on multiple media
servers when you calculate the required bandwidth.
Default value: 100
Possible values: 0 to 100

Work time

Use this field to specify the time interval that is considered work
time for the cloud connection.
Specify a start time and end time in 24-hour format. For example,
2:00 P.M. is 14:00.
Indicate how much bandwidth the cloud connection can use in the
Allocated bandwidth field. This value determines how much of
the available bandwidth is used for cloud operations in this time
window. The value is expressed as a percentage or in kilobytes
per second.

228

Configuring Host Properties

Servers properties

Table 3-58

Advanced Throttling Configuration settings (continued)

Property

Description

Off time

Use this field to specify the time interval that is considered off time
for the cloud connection.
Specify a start time and end time in 24-hour format. For example,
2:00 P.M. is 14:00.
Indicate how much bandwidth the cloud connection can use in the
Allocated bandwidth field. This value determines how much of
the available bandwidth is used for cloud operations in this time
window. The value is expressed as a percentage or in kilobytes
per second.

Weekend

Specify the start and stop time for the weekend.

Indicate how much bandwidth the cloud connection can use in the
Allocated bandwidth field. This value determines how much of
the available bandwidth is used for cloud operations in this time
window. The value is expressed as a percentage or in kilobytes
per second.

Read Bandwidth
(KB/s)

This field displays how much of the available bandwidth the cloud
storage server transmits to a NetBackup media server during each
restore job. The value is expressed in kilobytes per second.

Write Bandwidth
(KB/s)

This field displays how much of the available bandwidth the

NetBackup media server transmits to the cloud storage server
during backup jobs. The value is expressed in kilobytes per second.

Servers properties
The Servers properties display the NetBackup server lists on selected master
servers, media servers, and clients. The server lists display the NetBackup servers
that each host recognizes.
The Master Server field contains the name of the master server for the selected
host. (The name of the selected host appears in the title bar.)
The Servers dialog box contains the following tabs:

229

Configuring Host Properties

Servers properties

Table 3-59

Servers dialog box properties

Tab

Description

Additional Servers tab

This tab (Figure 3-65) lists the additional servers that can access the server that is
specified as Master server.
During installation, NetBackup sets the master server to the name of the system where
the server software is installed. NetBackup uses the master server value to validate
server access to the client. The master server value is also used to determine which
server the client must connect to so that files can be listed and restored.
To configure access to a remote server, add to the server list the name of the host seeking
access.

Note: For a Fibre Transport (FT) media server that has multiple network interfaces for
VLANs: Ensure that the FT servers primary host name appears before any other interface
names for that FT media server host.
For more information, see the NetBackup SAN Client and Fibre Transport Guide.
See Accessing remote servers on page 1115.
Media Servers tab

This tab (Figure 3-66) lists the hosts that are media servers only. Hosts that are listed
as media servers can back up and restore clients, but have limited administrative
privileges.
If a server appears only on the Media servers tab, the server is a media server. Media
servers can back up and restore clients, but they have limited administrative privileges.
A server that appears on the Media servers tab and the Additional servers tab may
introduce unintended consequences. A computer that is defined as both a master server
and a media server gives the administrator of the media server full master server
privileges. By listing the media server in both places, you may inadvertently give the
media server administrator more privileges than intended.

OpsCenter Servers tab

This tab (Figure 3-67) lists the Symantec NetBackup OpsCenter servers that can access
the currently selected master server.
To add a server to the list, ensure that the NetBackup server can reach the OpsCenter
server.
For more information, see the Symantec NetBackup OpsCenter Administrator's Guide.

230

Configuring Host Properties

Servers properties

Table 3-59

Servers dialog box properties (continued)

Tab

Description

Trusted Master Servers

tab

Use this tab (Figure 3-68) to add the remote master servers that you trust and to view
the master servers that are already trusted.
See About trusted master servers for Auto Image Replication on page 988.
See Adding a trusted master server on page 238.

Note: If either the source or remote master server is clustered, you must enable inter-node
communication on all of the nodes in the cluster. Do so before you add the trusted master
server.
See Enabling NetBackup clustered master server inter-node authentication on page 236.
You cannot remove a trusted master server when an Import SLP is configured in that
master server's domain.
Information about Auto Image Replication and storage lifecycle policies is available.
See About NetBackup Auto Image Replication on page 976.
See About storage lifecycle policies on page 590.
If you use NetBackup Access Control, read about access control with Auto Image
Replication.
See Using NetBackup Access Control (NBAC) with Auto Image Replication on page 993.

231

Configuring Host Properties

Servers properties

Figure 3-65

Additional servers tab in the Servers dialog box

232

Configuring Host Properties

Servers properties

Figure 3-66

Media servers tab in the Servers dialog box

233

Configuring Host Properties

Servers properties

Figure 3-67

OpsCenter servers tab in the Servers dialog box

234

Configuring Host Properties

Servers properties

Figure 3-68

Trusted Master Servers tab in the Servers dialog box

Adding a server to a servers list

Depending on the tab that is selected, you can add a master server, media server,
client, indexing server, or OpsCenter server to the server list in the Additional
servers tab, the Media servers tab, or the OpsCenter servers tab. All tabs appear
in the Servers properties dialog box.
To add a server to a list

In the NetBackup Administration Console, in the left pane, expand

NetBackup Management > Host Properties.

Depending on the host to be configured, select Master Servers, Media

Servers, or Clients.

In the right pane, double-click the master server, media server, or client that
you want to modify.

In the properties dialog box, in the left pane, click Servers.

Select the tab that contains the server list that you want to modify.

235

Configuring Host Properties

Servers properties

Click Add.
To add multiple hosts, select more than one media server or client in step 2
and click Apply To All in step 5. However, you can add only one master server
to the list at a time.

In the Add a New Server Entry dialog box, type the name of the new server.

Click Add. The dialog box remains open for another entry.

Click Close.

Note: If you add a media server, run nbemmcmd -addhost to add the media server
to the Enterprise Media Manager (EMM) in the NetBackup database of the master
server.

Removing a server from a server list

You can remove a master server or a media server from the Additional servers
list. You can also remove a media server from the Media servers list.
To remove a server from a server list

In the NetBackup Administration Console, in the left pane, expand

NetBackup Management > Host Properties.

Depending on the host to be configured, select Master Servers, Media

Servers, or Clients.

In the right pane, double-click the master server, media server, or client you
want to modify.

In the properties dialog box, in the left pane, click Servers.

Select a server from the Additional servers list, the Media servers list, or the
OpsCenter servers list.

Click Remove.

Enabling NetBackup clustered master server inter-node

authentication
To enable inter-node authentication among the NetBackup master servers in a
cluster, you must provision an authentication certificate on all of the nodes of the
cluster. The certificates are used to establish SSL connections between the
NetBackup hosts. The inter-node authentication allows the following NetBackup
functionality:

236

Configuring Host Properties

Servers properties

Targeted AIR (Auto Image

Replication)

237

Targeted AIR requires a trust relationship between the master

servers. The NetBackup authentication certificates provide
the means to establish a trust relationship.
Provision the certificates before you add the trusted master
server. This requirement applies regardless of whether the
clustered mastered server is the source of the replication
operation or the target.

NetBackup Java
Administration Console

The NetBackup Java Administration Console in master server

clusters requires the NetBackup authentication certificates
for correct functionality.
NetBackup Java Administration Console is the default console
on UNIX and Linux systems. Optionally, you can run it on
Windows systems.

See Adding a trusted master server on page 238.

To enable clustered master server inter-node authentication

On the active node of the NetBackup master server cluster, run the following
NetBackup command:

UNIX: /usr/openv/netbackup/bin/admincmd/bpnbaz -setupat

Windows: install_path\Veritas\NetBackup\bin\admincmd\bpnbaz
-setupat

NetBackup creates the certificates on every node in the master server cluster.
The following is example output:
# bpnbaz -setupat
You will have to restart NetBackup services on this machine after
the command completes successfully.
Do you want to continue(y/n)y
Gathering configuration information.
Please be patient as we wait for 10 sec for the security services
to start their operation.
Generating identity for host 'bit1.remote.symantecs.org'
Setting up security on target host: bit1.remote.symantecs.org
nbatd is successfully configured on NetBackup Master Server.
Operation completed successfully.

Configuring Host Properties

Servers properties

Adding a trusted master server

You can configure a trust relationship between multiple NetBackup domains. To
do so, in a source domain you specify the remote master servers with which you
want to add a trust relationship. Use the following procedure in the source domain
to add a remote master server as a trusted master server.
A trust relationship between domains helps with replication operations.
See About trusted master servers for Auto Image Replication on page 988.
Note: If either the source or remote master server is clustered, you must enable
inter-node communication on all of the nodes in the cluster. Do so before you add
the trusted master server.
See Enabling NetBackup clustered master server inter-node authentication
on page 236.
To add a trusted master server

In the NetBackup Administration Console, expand NetBackup Management

> Host Properties > Master Servers in the left pane.

In the right pane, select the master server.

On the Actions menu, click Properties.

In the properties dialog box left pane, select Servers.

In the Servers dialog box, select the Trusted Master Servers tab.

238

Configuring Host Properties

Servers properties

On the Trusted Master Servers tab, click Add.

The Add a New Trusted Master Server dialog box appears.
The following is an example of the dialog box:

In the Add a New Trusted Master Server dialog box, enter the following and
then click OK:

The fully-qualified host name of the remote master server.

The logon account User name of the remote master server host.

The Password for the logon account of the remote master server host.

Repeat step 6 and step 7 for each master server with which you want to add
a trust relationship.

When you finish adding trusted master servers, click OK.

Removing a trusted master server

You can remove a remote master server with which you have configured a trust
relationship.
A trust relationship between domains helps with replication operations.
See About trusted master servers for Auto Image Replication on page 988.
To remove a trusted master server for inter-domain operations

In the NetBackup Administration Console, expand NetBackup Management

> Host Properties > Master Servers in the left pane.

In the right pane, select the master server.

239

Configuring Host Properties

Servers properties

On the Actions menu, click Properties.

In the properties dialog box left pane, select Servers.

In the Servers dialog box, select the Trusted Master Servers tab.

On the Trusted Master Servers tab, select the trusted master server that you
want to remove and click Remove.
The Remove Trusted Master Server dialog box appears.
The following is an example of the dialog box:

In the Remove Trusted Master Server dialog box, enter the credentials for
that master server host and then click Remove.

Repeat step 6 for each master server with which you want to add a trust
relationship.

When you finish removing trusted master servers, click OK.

Changing the master server that performs backups and restores for
a client
Use the Make Master option to change the master server that performs backups
and restores for a client. This option does not change a host into a master server.
This option is useful in a disaster recovery situation or in a NetBackup environment
where Auto Image Replication is configured. For example, select a client in the

240

Configuring Host Properties

SharePoint properties

source domain, then use Make Master to temporarily point the client to the master
server of the target domain. After changing the master server, restores from the
target domain can be initiated.
To change the master server that a client uses for backups and restores

In the NetBackup Administration Console, in the left pane, expand

NetBackup Management > Host Properties.

Depending on the host to be configured, select Master Servers, Media

Servers, or Clients.

In the details pane, double-click the master server, media server, or client you
want to modify.

In the dialog box, click Servers.

From the Additional servers list, select a server.

Click Make Master.

In the configuration file, the new master server appears as the first server entry
in the list.
Changing the master server does not prevent the former master server from
initiating backups for the client. As long as that server continues to be listed
on the clients server list, the master server can perform backups.

SharePoint properties
The SharePoint properties apply to currently selected Windows clients to protect
SharePoint Server installations.

241

Configuring Host Properties

SharePoint properties

Figure 3-69

SharePoint dialog box

The SharePoint dialog box contains the following properties.

Table 3-60

SharePoint dialog box properties

Property

Description

Domain\User name

Specifies the domain and the user name for the account you
want to use to log on to SharePoint (DOMAIN\user name).

Password

Specifies the password for the account.

Consistency check before

backup

Specifies the consistency checks to perform on the SQL

Server databases before NetBackup begins a backup
operation. These checks are performed for both
server-directed and user-directed backups.
If you choose to perform a consistency check, you can select
Continue with backup if consistency check fails.
NetBackup then continues to perform the backup if the
consistency check fails.

242

Configuring Host Properties

SLP Parameters properties

Table 3-60
Property

SharePoint dialog box properties (continued)

Description

SharePoint granular restore For VMware and Hyper-V backups that protect Federated
proxy host
SharePoint configurations, provide the name of the back-end
SQL server. This server acts as the granular restore proxy
host for the catalog hosts (front-end servers in the farm).

For complete information on these options, see the NetBackup for Microsoft
SharePoint Server Administrators Guide.

Consistency check options for SharePoint Server

The following consistency checks can be performed before a SharePoint Server
backup.
Table 3-61

Consistency check options

Option

Description

None

Do not perform consistency checking.

Full check, excluding

indexes

Select this option to exclude indexes from the consistency check. If indexes are not
checked, the consistency check runs significantly faster but is not as thorough. Only
the data pages and clustered index pages for each user table are included in the
consistency check. The consistency of the non-clustered index pages is not checked.

Full check, including

indexes

Include indexes in the consistency check. Any errors are logged.

SLP Parameters properties

The SLP Parameters properties in the NetBackup Administration Console allow
administrators to customize how storage lifecycle policies are maintained and how
SLP jobs run. These properties apply to the SLPs of the currently selected master
servers.

243

Configuring Host Properties

SLP Parameters properties

Figure 3-70

SLP Parameters dialog box

In NetBackup 7.6 and earlier, the parameters that appear in the SLP Parameters
were configured in the LIFECYCLE_PARAMETERS configuration file. The host
properties replace that file. An upgrade to 7.6 migrates the settings in the
LIFECYCLE_PARAMETERS file to the SLP Parameters.
To change the parameters, either change them in the host properties or use the
command line. If either method is used to change a storage lifecycle policy parameter
default, the change creates the nbcl.conf configuration file.
The nbcl.conf file is found in the following locations, but is not present if the default
of any parameter has not been changed.

On Windows:
install_path\veritas\NetBackup\var\global\nbcl.conf

On UNIX:
/usr/openv/var/global/nbcl.conf

To use the command-line method, use the nbgetconfig and the nbsetconfig
commands to change the defaults. For information about these commands, see
the NetBackup Commands Reference Guide.

244

Configuring Host Properties

SLP Parameters properties

Table 3-62 describes the SLP Parameters and the default of each. It also lists the
configuration options and the syntax to use with the command-line method.
Use the drop-down menu in the Units column to change the units of measurement
for size or time.
Table 3-62

SLP Parameters

Property

Description

Minimum size per

duplication job

The smallest batch size that can run as a single duplication job. The job does not run
until enough images accumulate to reach this minimum batch size or until the Force
interval for small jobs time is reached. Minimum: 1 kilobyte; no maximum size. Default:
8 gigabytes.
Configuration option default: SLP.MIN_SIZE_PER_DUPLICATION_JOB = 8 GB

Maximum size per

duplication job

The largest batch size that can run as a single duplication job. Minimum: 1 kilobyte;
no maximum size. Default: 100 gigabytes.
Configuration entry default: SLP.MAX_SIZE_PER_DUPLICATION_JOB = 100 GB

Maximum size per A.I.R.

replication job

The largest batch size that can run as a single job for Auto Image Replication. Minimum:
1 kilobyte; no maximum size. Default: 100 gigabytes.
Configuration entry default: SLP.MAX_SIZE_PER_BACKUP_REPLICATION_JOB =
100 GB

Maximum images per

snapshot replication job

The largest number of images in a single batch that can run as a single job. Default:
50 images, with no minimum or maximum number.
Use this parameter with the Limit I/O streams disk pool option which limits the number
of jobs that can run concurrently to each volume in the disk pool.
Configuration entry default: SLP.MAX_IMAGES_PER_SNAPSHOT_REPLICATION_JOB
= 50

Minimum images per A.I.R. The fewest number of images in a single batch that can run as an Auto Image
Import job
Replication import job. The job does not run until either the minimum size is reached
or the Force interval for small jobs time is reached. Minimum: 1 image; no maximum
number of images. Default: 1 image.
Configuration entry default: SLP.MIN_IMAGES_PER_IMPORT_JOB = 1
Maximum images per A.I.R. The largest number of images in a single batch that can run as an Auto Image
Import job
Replication import job. Minimum: 1 job; no maximum number of images. Default: 250
images.
Configuration entry default: SLP.MAX_IMAGES_PER_IMPORT_JOB = 250

245

Configuring Host Properties

SLP Parameters properties

Table 3-62
Property

SLP Parameters (continued)

Description

Force interval for small jobs The age that the oldest image in a batch must reach after which the batch is submitted
as a duplication job. This prevents many small duplication jobs from running at one
time or running too frequently. It also prevents NetBackup from waiting too long before
it submits a small job. Default: 30 minutes, with no minimum or maximum number.
Configuration entry default: SLP.MAX_TIME_TIL_FORCE_SMALL_DUPLICATION_JOB
= 30 MINUTES
Job submission interval

Indicates the frequency of the job submission for all operations. No minimum or
maximum interval. Default: 5 minutes.
By default, all jobs are processed before more jobs are submitted. Increase this interval
to allow NetBackup to submit more jobs before all jobs are processed. Set the interval
when the list of available images is scanned for those that can be batched together
and jobs submitted. A shorter interval allows for a better response to changing system
workloads at the cost of increased processing.
Configuration entry default: SLP.JOB_SUBMISSION_INTERVAL = 5 MINUTES

Image processing interval

The number of minutes between image-processing sessions. Set the interval when
newly created images are recognized and set up for SLP processing. Default: 5 minutes.
Configuration entry default: SLP.IMAGE_PROCESSING_INTERVAL = 5 MINUTES

Cleanup interval

The time between when a job finishes and before NetBackup removes the job artifacts
for the completed job. No minimum or maximum interval. Default: 24 hours.
Configuration entry default: SLP.CLEANUP_SESSION_INTERVAL = 24 HOURS

Extended image retry

interval

The number of hours to wait before an unsuccessful operation is added to the next
duplication job. The extra time gives the administrator additional time to solve a problem
that prevents job completion. No minimum or maximum interval. Default: 2 hours.
Configuration entry default: SLP.IMAGE_EXTENDED_RETRY_PERIOD = 2 HOURS

Unused SLP definition

version cleanup delay

Concerns the deletion of SLP versions where a more recent version exists. The setting
controls how long a version must be inactive before NetBackup deletes it. Default: 14
days.
Configuration entry default: SLP.VERSION_CLEANUP_DELAY = 14 DAYS
See Deleting old storage lifecycle policy versions on page 649.

Tape resource multiplier

Limits the number of concurrently active duplication jobs that can access a single tape
media storage unit to xx times the number of available drives. Allows tuning to avoid
overloading the Resource Broker, yet makes sure that the devices are not idle. No
minimum or maximum multiplier. Default: 2 (multiply access to the write drives by two).
Configuration entry default: SLP.TAPE_RESOURCE_MULTIPLIER = 2

246

Configuring Host Properties

SLP Parameters properties

Table 3-62

SLP Parameters (continued)

Property

Description

Disk resource multiplier

Limits the number of concurrently active duplication jobs that can access a single disk
storage unit to xx times the number of available drives. Allows tuning to avoid
overloading the Resource Broker, yet makes sure that the devices are not idle. No
minimum or maximum multiplier. Default: 2 (multiply access to the write drives by two).
Configuration entry default: SLP.DISK_RESOURCE_MULTIPLIER = 2

Group images across SLPs If set to Yes (default), multiple SLPs of the same priority can be processed in the same
job. If No, batching can occur only within a single SLP.
Configuration entry default: SLP.DUPLICATION_GROUP_CRITERIA = 1
Configuration entry for no, do not allow
batching:SLP.DUPLICATION_GROUP_CRITERIA = 0
Window close buffer time

Sets the amount of time before a window closes when new jobs using that window will
no longer be submitted. Minimum 2 minute; maximum: 60 minutes. Default: 15 minutes.
Configuration entry default: SLP.WINDOW_CLOSE_BUFFER_TIME = 15 MINUTES

Deferred duplication offset For deferred operations, jobs are submitted x time before the source copy is due to
time
expire. Default: 4 hours.
Configuration entry default: SLP.DEFERRED_DUPLICATION_OFFSET_TIME = 4
HOURS
Auto create A.I.R. Import
SLP

Used for Auto Image Replication, indicates whether an SLP (that contains an Import
operation) is created automatically in the target domain if no SLP is configured there.
Default: Yes, an SLP is created in the target domain.
Configuration entry default: SLP.AUTO_CREATE_IMPORT_SLP = 1

How long to retry failed

A.I.R. import jobs

How long NetBackup retries an Import job before it stops and deletes the record. After
the initial four attempts, the retries become less frequent. Default: 0 (do not retry after
the initial four attempts).
Configuration entry default: SLP.REPLICA_METADATA_CLEANUP_TIMER = 0 HOURS

Command-line units of measurement for the SLP parameters

The abbreviations for units of measurement are case-insensitive.
The following abbreviations can be used where sizes are indicated:
bytes

kb

kilobyte

kilobyte(s)

kilobytes

mb

megabyte

megabyte(s)

megabytes

gb

gigabyte

gigabyte(s)

gigabytes

tb

terabyte

terabyte(s)

terabytes

pb

petabyte

petabyte(s)

petabytes

247

Configuring Host Properties

SLP Parameters properties

The following abbreviations can be used where units of time are indicated:
sec

second

second(s)

seconds

min

minute

minute(s)

minutes

hour

hour(s)

hours

day

day(s)

days

mon

month

month(s)

months

week

week(s)

weeks

year

year(s)

years

About batch creation logic in Storage Lifecycle Manager

The Storage Lifecycle Manager service (nbstserv) is in charge of creating
duplication jobs for storage lifecycle policies. Part of duplication job creation includes
grouping the backup (or source) jobs into batches.
Note: Restart nbstserv after making changes to the underlying storage for any
operation in an SLP.
One objective of the batching logic is to prevent media contention for tape operations,
including virtual tape libraries (VTL).
Batching logic applies to both disk and tape. (Though the method to prevent media
contention for disk is to use disk pools and then to limit I/O streams to disk pools.)
The batching logic requires that for each evaluation cycle, nbstserv consider all
completed source jobs when determining which duplication job to run next. By
default, nbstserv performs the evaluation once every 5 minutes.
nbstserv avoids overloading the Resource Broker (nbrb) queue with jobs. Too

many jobs in the queue make the role of the Resource Broker harder and slows
down system performance.
By default, nbstserv now creates groups based on the Group images across
SLPs parameter in the SLP Parameters host properties. By default, multiple storage
lifecycle policies with the same priority can be batched together.
See SLP Parameters properties on page 243.
This batching logic change affects how duplication jobs appear in the Activity
Monitor. Storage lifecycle policies that have been combined into one job appear
under a single policy name: SLP_MultipleLifecycles. If a storage lifecycle policy
has not been combined with another, the name appears in the Activity Monitor
under the name of the SLP: SLP_name.
Users may see some duplication jobs that, although in the running state, do not
duplicate data because they have no resources to read or write. These jobs continue
to run until they receive resources to complete the job.

248

Configuring Host Properties

Symantec Products properties

To turn off grouping by duplication job priority, set the Group images across SLPs
parameter to No in the SLP Parameters host properties.

Deprecated storage lifecycle policy parameters

Three storage lifecycle policy parameters were deprecated in NetBackup 7.6 due
to changes in SLP processing.
DUPLICATION_SESSION_INTERVAL_MINUTES is no longer effective in controlling
the timing of SLP processing sessions. Two parameters now control session
processing:

SLP.IMAGE_PROCESSING_INTERVAL controls how often new SLP-managed

images are recognized and set up for SLP processing.

SLP.JOB_SUBMISSION_INTERVAL controls how often SLP processing jobs

are submitted for execution.

Import operations are controlled by the same session that performs other SLP
operations. As a result, IMPORT_SESSION_TIMER and
IMPORT_EXTENDED_RETRY_SESSION_TIMER are no longer used.
As with other SLP operations, SLP.IMAGE_PROCESSING_INTERVAL and
SLP.JOB_SUBMISSION_INTERVAL now control the frequency of SLP session
operations. SLP.IMAGE_EXTENDED_RETRY_PERIOD controls the retry behavior
for all SLP operations including import operations.

Symantec Products properties

The Symantec Products properties encompass properties for other Symantec
products.
The Symantec Products properties include the subnode, Backup Exec Tape Reader
properties.
See Backup Exec Tape Reader properties on page 82.

Throttle Bandwidth properties

Use the Throttle Bandwidth properties to specify a limit for the network bandwidth
or transfer rate that NetBackup clients use on a network. The actual limiting occurs
on the client side of the backup connection. These properties limit only backups.
Restores are unaffected. The default is that the bandwidth is not limited.
The Throttle Bandwidth properties are similar to the Bandwidth host properties,
but offer greater flexibility in IPv6 environments.

249

Configuring Host Properties

Throttle Bandwidth properties

Figure 3-71

Throttle Bandwidth dialog box

To manage entries in the Throttle Bandwidth dialog box, select one of the following
buttons:
Add

Add a network or host to the Network or Host list using the Add
Bandwidth Settings dialog box.

Change

Change the selected network or host property using the Change

Bandwidth Settings dialog box.

Remove

Removes the selected network or host from the Network or Host

list.

Add Bandwidth Settings dialog box for Throttle Bandwidth properties

The Add Bandwidth Settings and the Change Bandwidth Settings dialog boxes
contain the following properties.
Network or Host

The network or host to which the throttle applies.

250

Configuring Host Properties

Timeouts properties

Bandwidth (KB/Sec)

The bandwidth or the transfer rate in kilobyte per second for

the network or host indicated. A value of zero disables
throttling IPv6 addresses.

Timeouts properties
The Timeouts properties apply to selected master servers, media servers, and
clients.
Figure 3-72

Timeouts dialog box

The Timeouts dialog box contains the following properties.

Table 3-63

Timeouts dialog box properties

Property

Description

Client connect timeout

Specifies the number of seconds the server waits before it times out when it connects
to a client. The default is 300 seconds.

251

Configuring Host Properties

Timeouts properties

Table 3-63
Property

Timeouts dialog box properties (continued)

Description

Backup start notify timeout Specifies the number of seconds the server waits for the bpstart_notify script on
a client to complete. The default is 300 seconds.

Note: If using the bpstart_notify script: The Client read timeout

(CLIENT_READ_TIMEOUT option) must be equal to or greater than the Backup start
notify timeout (BPSTART_TIMEOUT option). If the Client read timeout is less than
the Backup start notify timeout, the job can timeout while the bpstart_notify
script is running.
File browse timeout

Specifies how long the client can wait for a response from the NetBackup master server
while it lists files.

Note: If it exists, the value in a UNIX clients $HOME/bp.conf file takes precedence
to the property here.
If the limit is exceeded, the user receives a socket read failed error. The timeout can
be exceeded even while the server processes the request.
Use OS dependent timeouts Specifies that the client waits for the timeout period as determined by the operating
system when it lists files, as follows:

Media mount timeout

Windows client: 300 seconds

UNIX client: 1800 seconds

Specifies how long NetBackup waits for the requested media to be mounted, positioned,
and ready on backups, restores, and duplications.
This property applies to currently selected master servers.
Use this timeout to eliminate excessive waiting time during manual media mounts. (For
example, when robotic media is out of the robot or is off-site.)

252

Configuring Host Properties

Universal Settings properties

Table 3-63

Timeouts dialog box properties (continued)

Property

Description

Client read timeout

Specifies the number of seconds to use for the client-read timeout. This timeout can
apply to a NetBackup master, remote media server, or database-extension client (such
as NetBackup for Oracle). The default is 300 seconds.
If the server does not get a response from a client within the Client read timeout
period, the backup or restore operation, for example, fails.
The client-read timeout on a database-extension client is a special case. Clients can
initially require more time to get ready than other clients. More time is required because
database backup utilities frequently start several backup jobs at the same time, slowing
the central processing unit.

Note: For database-extension clients, Symantec suggests that the Client read timeout
be set to a value greater than 5 minutes. 15 minutes are adequate for many installations.
For other clients, change this property only if the client encounters problems.
The sequence on a database-extension client is as follows:

NetBackup on the database-extension client reads the clients client-read timeout

to find the initial value. If the option is not set, the standard 5-minute default is used.
When the database-extension API receives the servers value, it uses it as the
client-read timeout.

See Client Settings properties for UNIX clients on page 108.

Note: If using the bpstart_notify script: The Client read timeout

(CLIENT_READ_TIMEOUT option) must be equal to or greater than the Backup start
notify timeout (BPSTART_TIMEOUT option). If the Client read timeout is less than
the Backup start notify timeout, the job can timeout while the bpstart_notify
script is running.
Backup end notify timeout Specifies the number of seconds that the server waits for the bpend_notify script
on a client to complete. The default is 300 seconds.

Note: If this timeout is changed, verify that Client read timeout is set to the same or
higher value.
Media server connect
timeout

Specifies the number of seconds that the master server waits before it times out when
it connects to a remote media server. The default is 30 seconds.

Universal Settings properties

Use the Universal Settings properties in the NetBackup Administration Console
to configure basic backup and restore settings. These properties apply to selected
master servers, media servers, indexing servers, and clients.

253

Configuring Host Properties

Universal Settings properties

Figure 3-73

Universal Settings dialog box

The Universal Settings dialog box contains the following options.

Table 3-64

Universal Settings dialog box properties

Property

Description

Restore retries

Specifies the number of attempts a client has to restore after a failure. (The default is
0; the client does not attempt to retry a restore. The client can try up to three times.)
Change Restore retries only if problems are encountered.
If a job fails after the maximum number of retries, the job goes into an incomplete state.
The job remains in the incomplete state as determined by the Move restore job from
incomplete state to done state property.
See Clean-up properties on page 89.
A checkpointed job is retried from the start of the last checkpointed file rather than at
the beginning of the job.
Checkpoint restart for restore jobs allows a NetBackup administrator to resume a
failed restore job from the Activity Monitor.
See Take checkpoints every __ minutes (policy attribute) on page 680.

254

Configuring Host Properties

Universal Settings properties

Table 3-64

Universal Settings dialog box properties (continued)

Property

Description

Browse timeframe for

restores

Specifies how long ago NetBackup searches for files to restore. For example, to limit
the browse range to one week before the current date, clear the Last full backup
check box and specify 7.
This limit is specified on the master server and applies to all NetBackup clients. A limit
can be specified on an individual client to reduce the size of the Search window. The
client setting cannot make the browse window larger.
By default, NetBackup includes files from the time of the last-full backup through the
latest backup for the client. If the client belongs to more than one policy, then the browse
starts with the earliest of the set of last-full backups.

Last full backup

Indicates whether NetBackup includes all backups since the last successful full backup
in its browse range. This property must be disabled to enter a value for the Browse
timeframe for restores property. The default is that this property is enabled.

Use specified network

interface

Specifies the network interface that NetBackup uses to connect to another NetBackup
client or server. A NetBackup client or server can have more than one network interface.
To force NetBackup connections to be made on a specific network interface, use this
entry to specify the network host name of that interface. By default, the operating
system determines the one to use.

Allow server file writes

Specifies whether a NetBackup server can create or modify files on the NetBackup
client. For example, enable this property to prevent server-directed restores and remote
changes to the client properties.
After the Allow server file writes property is applied, it can be cleared only by modifying
the client configuration. The default is that server writes are allowed.

255

Configuring Host Properties

Universal Settings properties

Table 3-64
Property

Description

Logging the status of a

redirected restore

UNIX only:

Universal Settings dialog box properties (continued)

No progress log is produced for a redirected restore if the requesting server is not
included in the server list for the server that performs the restore. (A progress log is
an entry in the Task Progress tab of the Backup, Archive, and Restore client interface.)
Without the entry in the server list, the restoring server has no access to write the log
files to the requesting server.
Consider the following solutions:

Accept connections on
nonreserved ports

To produce a progress log, add the requesting server to the server list and log into
the requesting server.
In the NetBackup Administration Console, expand NetBackup Management
> Host Properties > Master Servers.
In the details pane, double-click on master server you want to modify, and click
Servers from the options pane.
Add the restoring server to the server list.

Log on to the restoring server. Check the Activity Monitor to determine the success
of the restore operation.

Specifies whether the NetBackup client service (bpcd) can accept remote connections
from non-reserved ports. (Non-reserved ports have port numbers of 1024 or greater.)
The default is that this property is enabled.
This property no longer applies. For information about this property, refer to NetBackup
6.5 documentation.

Client sends mail

Specifies whether the client sends an email to the address that is specified in the
Universal Settings properties. If the client cannot send email, use Server sends mail.
The default is that this property is enabled.

Server sends mail

Specifies whether the server sends an email to the address that is specified in the
Global Attributes properties. Enable this property if the client cannot send mail and
you want an email notification. The default is that this property is disabled.
See Global Attributes properties on page 158.

Client administrators email Specifies the email address of the administrator on the client. This address is where
NetBackup sends backup status reports for the client. By default, no email is sent. To
enter multiple addresses or email aliases, separate entries with commas.

Logging the status of a redirected restore

A redirected restore may not produce a progress log. The name of the requesting
server must appear in the server list for the server that performs the restore.

256

Configuring Host Properties

UNIX Client properties

Otherwise, no progress log is produced for a redirected restore.(A progress log is

an entry in the Task Progress tab of the Backup, Archive, and Restore client
interface.)
Without the entry in the server list, the restoring server has no access to write the
log files to the requesting server. Add the requesting server to the server list and
log into the requesting server.
To produce a progress log

In the NetBackup Administration Console, in the left pane, expand

NetBackup Management > Host Properties > Master Servers.

In the right pane, double-click the master server you want to modify.
In the properties dialog box, in the left pane, click Servers.

Perform one of the following actions:

Additional servers
From the Media servers list, click Add.

Media servers
From the Additional servers list, click Add.

In the Add a New Server Entry dialog box, type the name of the new server.

Click Add. The dialog box remains open for another entry.

Click Close.

Log on to the restoring server.

Check the Activity Monitor to determine the success of the restore operation.
See About the Jobs tab on page 1019.

UNIX Client properties

Use the UNIX Client properties in the NetBackup Administration Console to
define properties of clients running on the UNIX platform.

257

Configuring Host Properties

UNIX Server properties

Figure 3-74

UNIX Client dialog box

See Client Settings properties for UNIX clients on page 108.

See Busy File Settings properties on page 86.
See Lotus Notes properties on page 178.

UNIX Server properties

Use the UNIX Server properties in the NetBackup Adminstration Console to
change the NFS access timeout property. This property specifies how long the
backup waits to process the mount table before it considers an NFS file system
unavailable. The default is 5 seconds.
These properties apply to selected UNIX master servers.

258

Configuring Host Properties

VMware Access Hosts properties

Figure 3-75

UNIX Server dialog box

See Follow NFS (policy attribute) on page 687.

VMware Access Hosts properties

Use the VMware Access Hosts properties in the NetBackup Administration
Console to add or remove VMware backup hosts. These properties apply to
currently selected master servers.
These properties appear when the NetBackup Enterprise Client license is installed.

259

Configuring Host Properties

VMware Access Hosts properties

Figure 3-76

VMware Access Hosts dialog box

The backup host is a NetBackup client that performs backups on behalf of the virtual
machines. (This host was formerly known as the VMware backup proxy server.)
The backup host is the only host on which NetBackup client software is installed.
As an option, the backup host can also be configured as a NetBackup master server
or media server.
The backup host is referred to as the recovery host when it performs a restore
You can add servers to and remove servers from the access hosts list:
Add

Click Add and enter the fully qualified domain name of the backup host.

Remove

Select the backup host in the list and click Remove.

For more information, see the NetBackup for VMware Administrators Guide.

260

Configuring Host Properties

Windows Client properties

Windows Client properties

Use the Windows Client properties in the NetBackup Administration Console
to define NetBackup properties for Microsoft Windows clients.
Figure 3-77

Windows Client dialog box

Windows Client properties include specific host properties for configuring Windows
clients.

Configuration options not found in the Host

Properties
Most NetBackup configuration options can be found in the Host Properties of the
NetBackup Administration Console. However, some options cannot be accessed
in the Host Properties.
To change the default value for an option that is not found in the Host Properties,
first use the nbgetconfig command to obtain a list of configuration options. Then
use nbsetconfig to change the options as needed.

261

Configuring Host Properties

Configuration options not found in the Host Properties

For information about these commands, see the NetBackup Commands Reference
Guide.
The following NetBackup administration options cannot be configured by using the
NetBackup Administration Console.
AUTO_ADD_ALL_ALIASES_FOR_CLIENT

See AUTO_ADD_ALL_ALIASES_FOR_CLIENT option for

NetBackup servers on page 268.

BPARCHIVE_POLICY

See BPARCHIVE_POLICY option for NetBackup clients

on page 331.

BPARCHIVE_SCHED

See BPARCHIVE_SCHED option for NetBackup clients

on page 331.

BPBACKUP_POLICY

See BPBACKUP_POLICY option for NetBackup clients

on page 332.

BPBACKUP_SCHED

See BPBACKUP_SCHED option for NetBackup clients

on page 333.

BPDBJOBS_COLDEFS

See BPDBJOBS_COLDEFS options for UNIX master servers

on page 270.

CHECK_RESTORE_CLIENT

See CHECK_RESTORE_CLIENT option for NetBackup

servers on page 279.

EMMSERVER

See EMMSERVER option for NetBackup servers on page 293.

GENERATE_ENGLISH_LOGS

See GENERATE_ENGLISH_LOGS option for NetBackup

servers and clients on page 296.

IGNORE_XATTR

See IGNORE_XATTR option for NetBackup clients

on page 346.

INFORMIX_HOME

See INFORMIX_HOME option for NetBackup clients

on page 348.

KEEP_DATABASE_COMM_FILE

See KEEP_DATABASE_COMM_FILE option for NetBackup

clients on page 348.

REPORT_CLIENT_DISCOVERIES

See REPORT_CLIENT_DISCOVERIES option for NetBackup

clients on page 353.

RESUME_ORIG_DUP_ON_OPT_DUP_FAIL

See RESUME_ORIG_DUP_ON_OPT_DUP_FAIL option for

NetBackup servers on page 313.

SYBASE_HOME

See SYBASE_HOME option for NetBackup clients

on page 356.

262

Configuring Host Properties

About using commands to change the configuration options on UNIX clients and servers

See ULINK_ON_OVERWRITE option for NetBackup servers

on page 325.

ULINK_ON_OVERWRITE

vm.conf file (media and device configuration options) See the NetBackup Administrator's Guide, Volume II.

About using commands to change the configuration

options on UNIX clients and servers
When commands (nbsetconfig or bpsetconfig) are used to change the
configuration options on UNIX NetBackup servers or clients, the commands change
the appropriate configuration files.
Most options are found in the following configuration file:
/usr/openv/netbackup/bp.conf

If a single UNIX system is running as both a client and a server, the bp.conf file
contains options for both the client and the server.
The bp.conf file observes the following syntax:

Use the # symbol to comment out lines.

Any number of spaces or tabs are allowed on either side of = signs.

Blank lines are allowed.

Any number of blanks or tabs are allowed at the start of a line.

Each nonroot user on a UNIX client can also have a personal bp.conf file in their
home directory:
$HOME/bp.conf

The options in personal bp.conf files apply only to user operations. During a user
operation, NetBackup checks the $HOME/bp.conf file before
/usr/openv/netbackup/bp.conf.
Root users do not have personal bp.conf files. NetBackup uses the
/usr/openv/netbackup/bp.conf file for root users.
Stop and restart all NetBackup daemons and utilities on the server after you make
a change to the bp.conf file on a UNIX master server. This action ensures that all
of the NetBackup processes use the new bp.conf values. This action is not required
for changes to bp.conf files on a client or to a $HOME/bp.conf file on the master
server.

263

Configuring Host Properties

Configuration options for NetBackup servers

The SERVER option must be present in the /usr/openv/netbackup/bp.conf file on

all NetBackup UNIX clients and servers. During installation, NetBackup sets the
SERVER option to the name of the master server where the software is installed. It
is the only required option in the bp.conf files. NetBackup uses internal software
defaults for all options in the bp.conf file, except SERVER.
The SERVER entries must be the same on all servers in a master and a media server
cluster. Symantec recommends (but does not require) that all other entries also
match on all servers. (The CLIENT_NAME option is an exception.)

Configuration options for NetBackup servers

The following topics are about configuration options for NetBackup servers. Nearly
all of these options can also be set in the Host Properties in the NetBackup
Administration Console.
See Configuration options not found in the Host Properties on page 261.

ALLOW_MEDIA_OVERWRITE option for NetBackup servers

This option overrides the NetBackup overwrite protection for various media formats
on removable media.
Table 3-65

ALLOW_MEDIA_OVERWRITE information

Usage

Description

Where to use

On NetBackup master servers.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
ALLOW_MEDIA_OVERWRITE = media_format
This option should appear only once in the configuration file.

Example

On the master server (and media servers if applicable), add the following entry to permit
overwriting the cpio format:
ALLOW_MEDIA_OVERWRITE = CPIO

264

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-65

ALLOW_MEDIA_OVERWRITE information (continued)

Usage

Description

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master or media server
> Media > Allow media overwrite.
See Media properties on page 182.

ALLOW_NON_RESERVED_PORTS option for NetBackup servers

and clients
This option is not applicable to NetBackup 7.0.1 or later.
This option specifies that the NetBackup Client daemon (bpcd) can accept remote
connections from unauthorized ports (port numbers 1024 or greater). If this option
is not present, bpcd requires remote connections to come from privileged ports
(port numbers 1024 or smaller). This option is useful when NetBackup clients and
servers are on opposite sides of a firewall.
Table 3-66

ALLOW_NON_RESERVED_PORTS information

Usage

Description

Where to use

On NetBackup master servers or clients.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
ALLOW_NON_RESERVED_PORTS = YES | NO
This option should appear only once in the configuration file.

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server, media
server, or client > Universal Settings > Accept Connections on Non-reserved Ports.
See Universal Settings properties on page 253.

AUTHENTICATION_DOMAIN option for NetBackup servers and

clients
This option defines a set of NetBackup product authentication principles.

265

Configuring Host Properties

Configuration options for NetBackup servers

AUTHENTICATION_DOMAIN information

Table 3-67
Usage

Description

Where to use

A master server, media server, or client that uses NetBackup product authentication
and authorization must have at least one AUTHENTICATION_DOMAIN entry listed for
this option. More than one domain can be specified.
If a media server or client does not define an authentication domain, it uses the
authentication domains of its master server.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
AUTHENTICATION_DOMAIN = domain "comment"
mechanism broker [port]
This option may appear more than once in the configuration file.
The following variables are defined:

domain is an Internet domain name or a Windows domain name.

"comment" is a quoted comment that describes the authentication domain.

mechanism is the authentication mechanism.

The keywords for various mechanisms are as follows:
NIS: Network Information Service version 1

NIS+: Network Information Service version 2

PASSWD: Local UNIX password file on the specified broker

VXPD: The NetBackup product authentication and authorization private database

WINDOWS: Windows Active Directory or primary domain controller

broker is the host name or IP address of the authentication broker.

port is the port number of the authentication broker. The default is the standard port
number for authentication brokers.

266

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-67

AUTHENTICATION_DOMAIN information (continued)

Usage

Description

Example

AUTHENTICATION_DOMAIN = mycompany.com "Typical UNIX logins"

NIS broker1.mycompany.com
AUTHENTICATION_DOMAIN = OurEnterprise "Typical Windows logins"
WINDOWS broker2.mycompany.com 5544
AUTHENTICATION_DOMAIN = mycompany.com "VxSS-Only Identities"
VXPD broker1.mycompany.com
AUTHENTICATION_DOMAIN = broker3.mycompany.com "Local
UNIX Logins on host broker3" PASSWD broker3.mycompany.com
In this example:

Equivalent Administration
Console property

mycompany.com is the Internet domain name and OurEnterprise is the Windows

domain name.
The broker on host name broker1 handles both NIS and private authentication
for NetBackup product authentication.
The broker on host name broker2 handles Windows authentication for NetBackup
product authentication.
broker2 uses the non-standard port number 5544.
The broker on host name broker3 uses its local /etc/passwd file for NetBackup
product authentication.

NetBackup Management > Host Properties > Double-click on master server or client
> Access Control > Authentication Domain.
See Authentication Domain tab of the Access Control properties on page 75.

AUTHORIZATION_SERVICE option for NetBackup servers

This option defines the NetBackup Product Authorization Service that the local
NetBackup server uses.
Table 3-68

AUTHORIZATION_SERVICE information

Usage

Description

Where to use

A master server that uses NetBackup product authorization must define an authorization
service. If a media server does not define an authorization service, it uses the
authorization service of the master server.

267

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-68

AUTHORIZATION_SERVICE information (continued)

Usage

Description

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
AUTHORIZATION_SERVICE = host [ port ]
The following variables are defined:

host is the host name or IP address of the authorization service.

port is the port number of the authorization service. The default is the standard port
number for the authorization service.

This option should appear only once in the configuration file.

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master or media server
> Access Control > Authorization Service.
See Authorization Service tab of the Access Control properties on page 76.

AUTO_ADD_ALL_ALIASES_FOR_CLIENT option for NetBackup

servers
This option allows client aliases to be automatically added to the NetBackup
database when bpdbm detects a new client in a backup policy.
Table 3-69

AUTO_ADD_ALL_ALIASES_FOR_CLIENT information

Usage

Description

Where to use

On NetBackup master servers.

268

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-69

AUTO_ADD_ALL_ALIASES_FOR_CLIENT information (continued)

Usage

Description

How to use

By default, AUTO_ADD_ALL_ALIASES_FOR_CLIENT is not present in the configuration

file. When AUTO_ADD_ALL_ALIASES_FOR_CLIENT is not present, the option is
enabled. That is, bpdbm is allowed to add client aliases automatically.
Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
AUTO_ADD_ALL_ALIASES_FOR_CLIENT = YES | NO
This entry should appear only once in the configuration file.

Example

The following entry prohibits bpdbm from adding a client alias automatically:
AUTO_ADD_ALL_ALIASES_FOR_CLIENT = NO

Equivalent Administration
Console property

No equivalent exists in the NetBackup Administration Console host properties.

BPBRM_VERBOSE option for NetBackup servers

The BPBRM_VERBOSE option is used for debugging purposes. It controls the amount
of information that NetBackup includes in the bpbrm debug log.
Table 3-70

BPBRM_VERBOSE information

Usage

Description

Where to use

On NetBackup master servers.

How to use

The default is that BPBRM_VERBOSE is the same value as the VERBOSE option (Global
logging level). The BPBRM_VERBOSE option overrides the VERBOSE option in the
configuration file.
Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
BPBRM_VERBOSE = -1 | 0 | 1 | 2 | 3 | 4 | 5
This entry should appear only once in the configuration file.

269

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-70
Usage

Description

Example

BPBRM_VERBOSE information (continued)

To use the same value as the VERBOSE option, enter:

BPBRM_VERBOSE = 0

This option is the same as setting the BPBRM logging level in the Logging host
properties to Same as Global.
To log the minimum amount of information, enter:
BPBRM_VERBOSE = -1
This option is the same as setting the BPBRM logging level to 0 in the Logging
host properties.
To log additional information, enter a value of 1 through 5:
BPBRM_VERBOSE = 1

This option is the same as setting the BPBRM logging level to 1 in the Logging
host properties.
To log the maximum amount of information, enter:
BPBRM_VERBOSE = 5
This option is the same as setting the BPBRM logging level to 5 in the Logging
host properties.

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server >
Logging > BPBRM logging level.
See the NetBackup Troubleshooting Guide for more information about the debug log.
See Logging properties on page 169.

BPDBJOBS_COLDEFS options for UNIX master servers

Use BPDBJOBS_COLDEFS entries to customize the output of the bpdbjobs process.
Add a BPDBJOBS_COLDEFS option for every column you want to include in the output.
Add BPDBJOBS_COLDEFS entries to the bp.conf file to customize the output of the
bpdbjobs process.
Table 3-71

BPDBJOBS_COLDEFS information

Usage

Description

Where to use

On a UNIX NetBackup master server.

270

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-71

BPDBJOBS_COLDEFS information (continued)

Usage

Description

How to use

Add BPDBJOBS_COLDEFS to the /usr/openv/netbackup/bp.conf file.

Add an entry for every column to include in the output by using the following format:
BPDBJOBS_COLDEFS = COLDEFS_ENTRY [minimum_size [true |
false]]
The following variables are defined:

Example

COLDEFS_ENTRY is the name of the column to include in the output.

minimum_size is the minimum column width. If not specified, the default is a width
of 5.

true indicates that the column should expand as needed. If not specified, true
is the default.

false indicates that the column should not expand beyond the minimum_size.

The order of the entries determines the order in which the column headings appear.
BPDBJOBS_COLDEFS
BPDBJOBS_COLDEFS
BPDBJOBS_COLDEFS
BPDBJOBS_COLDEFS
BPDBJOBS_COLDEFS
BPDBJOBS_COLDEFS
BPDBJOBS_COLDEFS
BPDBJOBS_COLDEFS
BPDBJOBS_COLDEFS

=
=
=
=
=
=
=
=
=

JOBID 5 true
TYPE 4 true
STATE 5 true
STATUS 6 true
POLICY 6 true
SCHEDULE 8 true
CLIENT 6 true
DSTMEDIA_SERVER 12 true
ACTPID 10 true

The appearance of BPDBJOBS_COLDEFS entries in the bp.conf file has the following
ramifications:

Equivalent Administration
Console property

The addition of any BPDBJOBS_COLDEFS option overrides all default columns.

All users on the local system see only those columns that are specified in the
bp.conf file.

No equivalent exists in the NetBackup Administration Console host properties.

Table 3-72 shows possible COLDEFS entries and the column which is created by
each.

271

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-72

COLDEFS entries

COLDEFS entry

Column Name

ACTIVEELAPSED

Active Elapsed (elapsed active time)

ACTPID

Active PID (PID of job)

ATTEMPT

Attempt

BACKUPTYPE

Backup Type

CLIENT

Client

COMPLETION

Completion (percent complete)

COMPRESSION

Compression (yes or no)

DEDUPRATIO

Dedup (shows deduplication rate in

bpdbjobs command output)

DSTMEDIA_SERVER

Dest Media Svr (writing media server)

DSTMEDIAID

Dest Media ID (writing media ID)

DSTSTORAGE_UNIT

Dest StUnit (writing storage unit)

ELAPSED

Elapsed (elapsed time)

ENDED

Ended

ESTFILE

Est File (estimated number of files)

ESTKB

Est KB (estimated number of kilobytes)

FILES

Files

GROUP

Group

JOBID

JobID

KBPERSEC

KB Per Sec

KILOBYTES

Kilobytes

LASTBACKUP

Last Backup (date and time)

MAINPID

Main PID (PID that spawns job, if applicable)

NUMTAPESEJECT

Media to Eject (number of tapes to eject;

Vault only)

272

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-72

COLDEFS entries (continued)

COLDEFS entry

Column Name

OPERATION

Operation (current operation)

OWNER

Owner

PATHNAME

Pathname

PARENTJOBID

Parent JobID

POLICY

Policy

POLICYTYPE

Policy Type

PRIORITY

Priority

PROFILE

Profile (Vault only)

RETENTION

Retention (retention period)

RESUMABLE

Resumable

ROBOT

Robot (Vault only)

RQSTPID

Request PID (PID requesting job, if

applicable)

SCHEDULE

Schedule

SCHEDULETYPE

Schedule Type

SESSIONID

Session ID (Vault only)

SRCMEDIA_SERVER

Src Media Svr

SRCMEDIAID

Src Media ID

SRCSTORAGE_UNIT

Src StUnit

STARTED

Started

STATE

State

STATUS

Status

STREAMNUMBER

Stream Number

SUSPENDABLE

Suspendable

TYPE

Type (job type)

273

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-72

COLDEFS entries (continued)

COLDEFS entry

Column Name

VAULT

Vault (Vault only)

BPDBM_VERBOSE option for NetBackup servers

The BPDBM_VERBOSE option is used for debugging purposes. It controls the amount
of information NetBackup includes in the bpdbm debug log.
Table 3-73

BPDBM_VERBOSE information

Usage

Description

Where to use

On NetBackup master servers.

How to use

The default is that BPDBM_VERBOSE is the same value as the VERBOSE option (Global
logging level). The BPDBM_VERBOSE option overrides the VERBOSE option in the
configuration file.
Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
BPDBM_VERBOSE = -1 | 0 | 1 | 2 | 3 | 4 | 5
This entry should appear only once in the configuration file.

274

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-73
Usage

Description

Example

BPDBM_VERBOSE information (continued)

To use the same value as the VERBOSE option for, enter:

BPDBM_VERBOSE = 0

This option is the same as setting the BPDBM logging level to Same as Global
in the Logging host properties.
To log the minimum amount of information, enter:
BPDBM_VERBOSE = -1
This option is the same as setting the BPDBM logging level to 0 in the Logging
host properties.
To log additional information, enter a value of 1 through 5:
BPDBM_VERBOSE = 1

This option is the same as setting the BPDBM logging level to 1 in the Logging
host properties.
To log the maximum amount of information, enter:
BPDBM_VERBOSE = 5
This option is the same as setting the BPDBM logging level to 5 in the Logging
host properties.

The following examples show two entries which enable logging, while they minimize
the growth rate of the bpdbm debug file:
VERBOSE = 5
BPDBM_VERBOSE = -1
Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server >
Logging > Global logging level > BPDBM logging level.
See the NetBackup Troubleshooting Guide for more information about logging.
See Logging properties on page 169.

BPRD_VERBOSE option for NetBackup servers

Used for debugging purposes, the BPRD_VERBOSE option controls the amount of
information that NetBackup includes in the bprd debug logs.
Table 3-74

BPRD_VERBOSE information

Usage

Description

Where to use

On NetBackup master servers.

275

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-74

BPRD_VERBOSE information (continued)

Usage

Description

How to use

The default is that the value is the same as the VERBOSE option (Global logging level).
The BPRD_VERBOSE option overrides the VERBOSE option in the configuration file.
Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
BPRD_VERBOSE = -1 | 0 | 1 | 2 | 3 | 4 | 5
This entry should appear only once in the configuration file.

Example

To use the same value as the VERBOSE option, enter:

BPRD_VERBOSE = 0

This option is the same as setting the BPRD logging level in the Logging host
properties to Same as Global.
To log the minimum amount of information, enter:
BPRD_VERBOSE = -1
This option is the same as setting the BPRD logging level to 0 in the Logging
host properties.
To log additional information, enter a value of 1 through 5:
BPRD_VERBOSE = 1

This option is the same as setting the BPRD logging level to 1 in the Logging
host properties.
To log the maximum amount of information, enter:
BPRD_VERBOSE = 5
This option is the same as setting the BPRD logging level to 5 in the Logging
host properties.

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server >
Logging > BPRD logging level.
See the NetBackup Troubleshooting Guide for more information about the debug log.
See Logging properties on page 169.

BPTM_VERBOSE option for NetBackup servers

The BPTM_VERBOSE option is used for debugging purposes. It controls the amount
of information that NetBackup includes in the bptm debug logs.

276

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-75

BPTM_VERBOSE information

Usage

Description

Where to use

On NetBackup master servers.

How to use

The default is that BPTM_VERBOSE is the same value as the VERBOSE option (Global
logging level). The BPTM_VERBOSE option overrides the VERBOSE option in the
configuration file.
Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
BPTM_VERBOSE = -1 | 0 | 1 | 2 | 3 | 4 | 5
This entry should appear only once in the configuration file.

Example

To use the same value as the VERBOSE option, enter:

BPTM_VERBOSE = 0

This option is the same as setting the BPTM logging level in the Logging host
properties to Same as Global.
To log the minimum amount of information, enter:
BPTM_VERBOSE = -1
This option is the same as setting the BPTM logging level to 0 in the Logging
host properties.
To log additional information, enter a value of 1 through 5:
BPTM_VERBOSE = 1

This option is the same as setting the BPTM logging level to 1 in the Logging
host properties.
To log the maximum amount of information, enter:
BPTM_VERBOSE = 5
This option is the same as setting the BPTM logging level to 5 in the Logging
host properties.

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server >
Logging > BPTM logging level.
See the NetBackup Troubleshooting Guide for more information about the debug log.
See Logging properties on page 169.

277

Configuring Host Properties

Configuration options for NetBackup servers

BPEND_TIMEOUT option for NetBackup servers

The BPEND_TIMEOUT option specifies the number of seconds to wait for the
bpend_notify script on a client to complete.
Table 3-76

BPEND_TIMEOUT information

Usage

Description

Where to use

On NetBackup master servers.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
BPEND_TIMEOUT = seconds
The default timeout is 300 seconds (five minutes).

Note: If this option is changed, verify that the CLIENT_READ_TIMEOUT option is set
to the same value or higher.
This entry should appear only once in the configuration file.
Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server >
Timeouts > Backup end notify timeout.
See Timeouts properties on page 251.

BPSTART_TIMEOUT option for NetBackup servers

The BPSTART_TIMEOUT option specifies the number of seconds to wait for the
bpstart_notify script on a client to complete.
Table 3-77

BPSTART_TIMEOUT information

Usage

Description

Where to use

On NetBackup master servers.

278

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-77

BPSTART_TIMEOUT information (continued)

Usage

Description

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
BPSTART_TIMEOUT = seconds
The default timeout is 300 seconds (five minutes).

Note: If using the bpstart_notify script: The Client read timeout

(CLIENT_READ_TIMEOUT option) must be equal to or greater than the Backup start
notify timeout (BPSTART_TIMEOUT option). If the Client read timeout is less than
the Backup start notify timeout, the job can timeout while the bpstart_notify
script is running.
This option should appear only once in the configuration file.
Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server >
Timeouts > Backup start notify timeout.
See Timeouts properties on page 251.

CHECK_RESTORE_CLIENT option for NetBackup servers

The CHECK_RESTORE_CLIENT option specifies that the client to be restored to is
checked before the restore starts. An unresponsive client can slow restores for
other clients that have data on the same tapes.
Table 3-78

CHECK_RESTORE_CLIENT information

Usage

Description

Where to use

On NetBackup master servers.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
This option should appear only once in the configuration file.

Equivalent Administration
Console property

No equivalent exists in the NetBackup Administration Console host properties.

279

Configuring Host Properties

Configuration options for NetBackup servers

CLIENT_CONNECT_TIMEOUT option for NetBackup servers

This option specifies the number of seconds that the server waits when it connects
to a client. If the server needs to wait longer than the time specified, it times out.
Table 3-79

CLIENT_CONNECT_TIMEOUT information

Usage

Description

Where to use

On NetBackup master servers.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
CLIENT_CONNECT_TIMEOUT = seconds
The default timeout is 300 seconds (five minutes).
This option should appear only once in the configuration file.

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server >
Timeouts > Client connect timeout.
See Timeouts properties on page 251.

CLIENT_PORT_WINDOW option for NetBackup servers and clients

This option specifies the range of non-reserved ports on this computer that are
used as source ports when connecting to NetBackup on other computers. This
setting applies to daemon or service socket connections to the server and to the
client hosts as well as call-back from bpcd.
Table 3-80

CLIENT_PORT_WINDOW information

Usage

Description

Where to use

On NetBackup servers and clients.

280

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-80

CLIENT_PORT_WINDOW information (continued)

Usage

Description

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
CLIENT_PORT_WINDOW = start_port_range end_port_range
If 0 is specified for the first number (default), the operating system determines the
non-reserved port to use.
This option should appear only once in the configuration file.

Example

The following example permits ports from 4800 through 5000:

CLIENT_PORT_WINDOW = 4800 5000

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server > Port
Ranges > Client port window.
See Port Ranges properties on page 194.

CLIENT_READ_TIMEOUT option for NetBackup servers

The CLIENT_READ_TIMEOUT option specifies the number of seconds to use for the
client-read timeout.
If the master server does not get a response from a client within the
CLIENT_READ_TIMEOUT period, the backup or restore operation, for example, fails.
Table 3-81

CLIENT_READ_TIMEOUT information

Usage

Description

Where to use

On NetBackup master servers.

281

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-81

CLIENT_READ_TIMEOUT information (continued)

Usage

Description

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
CLIENT_READ_TIMEOUT = seconds
By default, CLIENT_READ_TIMEOUT is not present on the server or the database
agent and the client-read timeout is 300 seconds (five minutes). This time is a
reasonable default. Change only in the event of problems.
CLIENT_READ_TIMEOUT on a database agent is a special case because these types
of clients can initially require more time to get ready than other clients. Database backup
utilities frequently start several backup jobs at the same time, which can slow the CPU.
The sequence on a database agent is as follows:

NetBackup on the database agent reads the clients CLIENT_READ_TIMEOUT to

find the value to use initially. If the option is not set, the standard default of five
minutes is used.
When the database agent API receives the servers value, it uses it as the
CLIENT_READ_TIMEOUT.

Note: Symantec suggests setting CLIENT_READ_TIMEOUT on the database agent to

a value greater than 5 minutes. A setting of 15 minutes is adequate for many
installations.

Note: If using the bpstart_notify script: The Client read timeout

(CLIENT_READ_TIMEOUT option) must be equal to or greater than the Backup start
notify timeout (BPSTART_TIMEOUT option). If the Client read timeout is less than
the Backup start notify timeout, the job can timeout while the bpstart_notify
script is running.
Example

The following example configures a client read timeout of 15 minutes.

CLIENT_READ_TIMEOUT = 900

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server >
Timeouts > Client read timeout.
See Timeouts properties on page 251.

282

Configuring Host Properties

Configuration options for NetBackup servers

CLIENT_RESERVED_PORT_WINDOW option for NetBackup servers

and clients
The CLIENT_RESERVED_PORT_WINDOW option specifies the range of reserved ports
on this computer that are used for connecting to NetBackup on other computers.
This setting applies when the computer connects to a client (bpcd) configured to
accept only reserved ports.
Beginning with NetBackup 7.0.1, connections to other daemon ports use only the
CLIENT_PORT_WINDOW, not the CLIENT_RESERVED_PORT_WINDOW.
Table 3-82

CLIENT_RESERVED_PORT_WINDOW information

Usage

Description

Where to use

On NetBackup master servers or clients.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
CLIENT_RESERVED_PORT_WINDOW = start_port_range end_port_range
The default is from 512 through 1023. Note that if 0 is specified for the first number, a
non-reserved port is used instead. The operating system chooses the nonreserved
port.
This option should appear only once in the configuration file.

Example

The following example permits ports from 900 through 1023:

CLIENT_RESERVED_PORT_WINDOW = 900 1023

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server > Port
Ranges > Client reserved port window.
See Port Ranges properties on page 194.

CONNECT_OPTIONS option for NetBackup servers and clients

The CONNECT_OPTIONS option specifies the following options that are designed to
enhance firewall efficiency with NetBackup:

Whether processes on host are reached:

By using the Veritas Network daemon (vnetd) port only.

By using the daemon ports only.

283

Configuring Host Properties

Configuration options for NetBackup servers

By first using the vnetd port and then the daemon ports if needed.

Whether subsequent call-back connections with host use the traditional call-back
method or use vnetd.

Whether connections to host use reserved or a non-reserved port number.

Table 3-83

CONNECT_OPTIONS information

Usage

Description

Where to use

On NetBackup master servers, media servers, or clients.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
CONNECT_OPTIONS = host [ 0 | 1 | 2 ]
[ 0 | 1 | 2 ][ 0 | 1 | 2 | 3]
The following variables are defined:
Host is a NetBackup system to which this computer connects. You may have multiple
CONNECT_OPTIONS entries in the configuration. If a host is not specified in any
CONNECT_OPTIONS entries, the values from the DEFAULT_CONNECT_OPTIONS option
are used.
See DEFAULT_CONNECT_OPTIONS option for NetBackup servers and clients
on page 287.
The first setting indicates the type of port to use as the source port for connections to
service daemons on host:
0 = Connections from this computer should be from a reserved source port number.
It is selected from the CLIENT_RESERVED_PORT_WINDOW range.
1 = Connections from this computer should be from a non-reserved source port number
that is selected from the CLIENT_PORT_WINDOW range. (The default is 1.) If this option
is selected for use with the daemon port and host is running a version of NetBackup
older than 7.1, enable Allow non reserved ports for the selected host.
In the NetBackup Administration Console, see the Universal Settings dialog box
under Host Properties > Media Servers.
2 = Use the method that the DEFAULT_CONNECT_OPTIONS configuration option
defines.
See Universal Settings properties on page 253.

284

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-83
Usage

CONNECT_OPTIONS information (continued)

Description
The second setting indicates the call-back method to use with host. (This applies if
configured to use the daemon port or if bpcd cannot be reached using ports 1556 or
13724.)
0 = Use the traditional call-back method. Host connects back to a random port number
that this computer has selected from the SERVER_RESERVED_PORT_WINDOW range,
or SERVER_PORT_WINDOW range as determined by the first setting.
1 = Use the vnetd no call-back method. Connect to vnetd instead of a random port.
If this computer is NetBackup 7.0.1 or later, attempt to connect to port 1556 before
attempting to connect to vnetd. The connection is outbound to host if the third setting
is 0 or 1. The connection is inbound from host if the third setting is 2.
2 = Use the method that the DEFAULT_CONNECT_OPTIONS configuration option defines
(default).
The third setting affects which destination port number to use for connections to daemon
services on host.
0 = Use vnetd if possible, to connect to a daemon on this computer. If it is not possible,
connect by using the traditional port number of the daemon. If this host is NetBackup
7.0.1 or later, attempt to connect to port 1556 before attempting to connect to vnetd.
If bpcd is reachable through port 1556 or vnetd, then the first two settings are ignored
and all connections to host are outbound and use non-reserved ports.
1 = Use vnetd to connect to a daemon on host. If this computer is NetBackup 7.0.1
or later, attempt to connect to port 1556 before attempting to connect to vnetd. The
traditional port number of the daemon is not used if the connection cannot be established
using port 1556 or vnetd. If bpcd is reachable through port 1556 or vnetd, then the
first two settings are ignored and all connections to host are outbound and use
non-reserved ports.
2 = Use only the traditional port number of the daemon to connect to a daemon on
host. If the daemon is bpcd, the second setting is then used to determine the call-back
method.
3 = Use the method that the DEFAULT_CONNECT_OPTIONS configuration option defines
(default).

285

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-83

CONNECT_OPTIONS information (continued)

Usage

Description

Example 1

The configuration file can contain CONNECT_OPTIONS settings for multiple hosts.
CONNECT_OPTIONS = shark 0 0 0
In this example, connections to daemons on shark attempt to use port 1556 if this
computer is running NetBackup 7.0.1 or later. If this computer is running a version of
NetBackup that is earlier than 7.0.1, or if the previous attempt was unsuccessful, then
the connections try vnetd. If that attempt is unsuccessful, the daemon port is used. If
the connections are successful using 1556 or vnetd, then the first two settings are
ignored.
$ bptestbpcd -host shark
0 0 1
10.82.105.11:40402 -> 10.82.104.249:1556
10.82.105.11:40404 -> 10.82.104.249:1556

Example 2

CONNECT_OPTIONS = dolphin 1 0 1
In this example, connections to daemons on dolphin attempt to use port 1556 if this
computer is running NetBackup 7.0.1 or later. If this computer is running a version of
NetBackup that is earlier than 7.0.1, of if the previous attempt was unsuccessful, then
the connections try vnetd. The first two settings are ignored.
$ bptestbpcd -host dolphin
1 0 1
10.82.105.11:40414 -> 10.82.104.249:13724
10.82.105.11:40416 -> 10.82.104.249:13724

Example 3

CONNECT_OPTIONS = perch 0 1 2
In this example:

Connections to daemons on perch must use the daemon port numbers.

Call-back connections are inbound to vnetd on this computer.

The source ports for all connections are bound from the reserved port number
range.

286

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-83

CONNECT_OPTIONS information (continued)

Usage

Description

Example 4

CONNECT_OPTIONS = trout 1 1 2
In this example:

Equivalent Administration
Console property

Connections to daemons on trout must use the daemon port numbers.

Call-back connections are inbound to vnetd on this computer.

The source ports for all connections are bound from the non-reserved port number
range.

NetBackup Management > Host Properties > Double-click on master server, media
server, or client > Firewall.
See Firewall properties on page 150.

DEFAULT_CONNECT_OPTIONS option for NetBackup servers and

clients
The DEFAULT_CONNECT_OPTIONS option specifies the default values for the
CONNECT_OPTIONS configuration option. If a host name is not specified in any
CONNECT_OPTIONS option, the value from the DEFAULT_CONNECT_OPTIONS option is
used.
See CONNECT_OPTIONS option for NetBackup servers and clients on page 283.
Table 3-84

DEFAULT_CONNECT_OPTIONS information

Usage

Description

Where to use

On NetBackup master servers, media servers, or clients.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
DEFAULT_CONNECT_OPTIONS = [ 0 | 1 ][ 0 | 1 ][ 0 | 1 | 2 ]
The default value is 1 1 0.
This option should appear only once in the configuration file.

287

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-84
Usage

DEFAULT_CONNECT_OPTIONS information (continued)

Description
The first setting indicates the type of port to use as the source port when connecting
to service daemons on a destination host. It also indicates the type of server port if
using the traditional call-back method.
0 = Connections on this computer should use a reserved port number. They are selected
from the CLIENT_RESERVED_PORT_WINDOW range for source ports and from the
SERVER_RESERVED_PORT_WINDOW range if using the traditional call-back method.
1 = Connections on this computer should use a non-reserved port number. (1 is the
default.) Connections are selected from the CLIENT_PORT_WINDOW range for source
ports and from the SERVER_PORT_WINDOW range if using the traditional call-back
method. If this option is selected and the destination host is earlier than NetBackup
7.1, enable Allow non reserved ports for the selected host. See the Universal
Settings dialog box under Host Properties > Media Servers.
See Universal Settings properties on page 253.
The second setting indicates the call-back method to use. (This setting applies if
configured to use the daemon port or if bpcd cannot be reached using ports 1556 or
13724.)
0 = Use the traditional call-back method. The destination host connects back to a
random port number that this computer has selected from the
SERVER_RESERVED_PORT_WINDOW range, or the SERVER_PORT_WINDOW range as
determined by the first setting.
1 = Use the vnetd no call-back method. Connect to vnetd instead of a random port.
If this computer is NetBackup 7.0.1 or later, attempt to connect to port 1556 before
attempting to connect to vnetd. The connection is outbound to the destination host if
the third setting is 0 or 1. The connection is inbound if the third setting is 2.

288

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-84
Usage

DEFAULT_CONNECT_OPTIONS information (continued)

Description
The third setting affects which destination port number to use when attempting
connections to daemon services on the destination host.
0 = Use vnetd to connect to a daemon on the destination host if possible, otherwise
connect by using the traditional port number of the daemon. If this computer is
NetBackup 7.0.1 or later, attempt to connect to port 1556 before attempting to connect
to vnetd. If bpcd is reachable through port 1556 or vnetd, then the first two settings
are ignored and all connections are outbound and use non-reserved ports.
1 = Connect to a daemon on the destination host by using vnetd. If this computer is
NetBackup 7.0.1 or later, attempt to connect to port 1556 before attempting to connect
to vnetd. The traditional port number of the daemon will not be used if the connection
cannot be established using port 1556 or vnetd. If bpcd is reachable through port
1556 or vnetd, then the first two settings are ignored and all connections are outbound
and use non-reserved ports.
2 = Connect to a daemon on the destination host by using the traditional port number
of the daemon only. The first setting is used to determine the port range and the second
setting is used to determine the call-back method.

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server, media
server, or client > Firewall.
See Firewall properties on page 150.

DISABLE_JOB_LOGGING option for NetBackup servers

This option disables the logging of the job information that the NetBackup Activity
Monitor requires.
Table 3-85

DISABLE_JOB_LOGGING information

Usage

Description

Where to use

On NetBackup master servers.

289

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-85

DISABLE_JOB_LOGGING information (continued)

Usage

Description

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
DISABLE_JOB_LOGGING
The default is that this option is not present in the configuration file and that job logging
occurs.

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server > Media
> Enable job logging.
See Media properties on page 182.

DISABLE_STANDALONE_DRIVE_EXTENSIONS option for

NetBackup servers
This option disables the nonrobotic drive operations. During a backup, NetBackup
automatically attempts to use standalone volumes in nonrobotic drives.
Table 3-86

DISABLE_STANDALONE_DRIVE_EXTENSIONS information

Usage

Description

Where to use

On NetBackup master servers.

How to use

Use the nbemmcmd command to change the option. For example:

nbemmcmd -changesetting -DISABLE_STANDALONE_DRIVE_EXTENSIONS no
See the NetBackup Commands Reference Guide.
This option should appear only once in the configuration file.

Example

The following command enables nonrobotic drive operations.

nbemmcmd -changesetting -DISABLE_STANDALONE_DRIVE_EXTENSIONS no

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server > Media
> Enable standalone drive extension. The default is that this option is enabled.
See Media properties on page 182.

290

Configuring Host Properties

Configuration options for NetBackup servers

DISALLOW_BACKUPS_SPANNING_MEDIA option for NetBackup

servers
This option prevents backups from spanning media.
Table 3-87

DISALLOW_BACKUPS_SPANNING_MEDIA information

Usage

Description

Where to use

On NetBackup master servers.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
DISALLOW_BACKUPS_SPANNING_MEDIA
The default is that the entry is not present in the configuration file and backups are
allowed to span media.

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server > Media
> Allow backups to span tape media.
See Media properties on page 182.

DISALLOW_CLIENT_LIST_RESTORE option for NetBackup servers

This option denies the list and restore requests for all clients. When this option is
present, clients cannot list or restore any files that they have backed up through
this master server.
Table 3-88

DISALLOW_CLIENT_LIST_RESTORE information

Usage

Description

Where to use

On NetBackup master servers.

291

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-88

DISALLOW_CLIENT_LIST_RESTORE information (continued)

Usage

Description

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
DISALLOW_CLIENT_LIST_RESTORE
The default is that the entry is not present in the configuration file and clients can list
and restore their files.

Note: Override the DISALLOW_CLIENT_LIST_RESTORE option for individual clients

by changing their list_restore setting.
Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server > Client
Attributes > Allow Client Restore.
See Client Attributes properties on page 93.

DISALLOW_CLIENT_RESTORE option for NetBackup servers

This option denies the restore requests for all clients. When this option is present,
clients cannot restore the files that they have backed up through this master server.
Table 3-89

DISALLOW_CLIENT_RESTORE information

Usage

Description

Where to use

On NetBackup master servers.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
DISALLOW_CLIENT_RESTORE
The default is that the entry is not present in the configuration file and clients can restore
their files.

Note: To override the DISALLOW_CLIENT_RESTORE option for individual clients,

change their list_restore setting.

292

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-89

DISALLOW_CLIENT_RESTORE information (continued)

Usage

Description

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server > Client
Attributes > Allow Client Browse.
See Client Attributes properties on page 93.

EMMSERVER option for NetBackup servers

In releases before NetBackup 7.6, EMMSERVER indicated the master or the media
server that acted as the Enterprise Media Manager server for one or more master
servers.
Support for remote-EMM and shared-EMM server configurations was withdrawn in
7.6. In a remote- or shared-EMM server configuration, the NetBackup relational
database (NBDB), the Enterprise Media Manager (EMM), and the Resource Broker
(RB) have been moved to a server that is not the master server. Customers who
currently use this option should contact Symantec Support. Support will engage
Symantec Engineering to review the options to disengage this configuration.
Table 3-90

EMMSERVER information

Usage

Description

Where to use

On NetBackup master servers.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
EMMSERVER = server_name
The EMMSERVER option applies only to servers at version 6.0 and later.

Equivalent Administration
Console property

No equivalent exists in the NetBackup Administration Console host properties.

See Moving the NetBackup database from one host to another on page 946.

ENABLE_ROBUST_LOGGING option for NetBackup servers

This option indicates to NetBackup to limit the amount of disk space that one debug
log directory consumes. When a log file grows to the maximum size, the log file is

293

Configuring Host Properties

Configuration options for NetBackup servers

closed and a new log file is opened. If the new log file causes the maximum number
of log files in the directory to be exceeded, the oldest log file is deleted.
Table 3-91

ENABLE_ROBUST_LOGGING information

Usage

Description

Where to use

On NetBackup master servers.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
ENABLE_ROBUST_LOGGING
The default is that the entry is not present in the configuration file. If it is present in the
bp.conf file, NetBackup uses the settings in the nblog.conf file as the unified
logging settings.
The maximum size of a log file is set by using the NetBackup command vxlogcfg
with parameters NumberOfLogFiles and MaxLogFileSizeKB.

Note: Do not edit the nblog.conf file manually.

See the NetBackup Troubleshooting Guide for more information on controlling the log
file size.
If a NetBackup environment uses scripts depending on the MMDDYY.log naming
convention, either update the scripts or uncheck Enable robust Logging.
Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server >
Logging > Enable robust logging.
See Logging properties on page 169.

FAILOVER_RESTORE_MEDIA_SERVERS option for NetBackup

servers
This option specifies that an automatic failover media server be used if a server is
temporarily inaccessible for a restore. This failover does not require administrator
intervention.
Table 3-92

FAILOVER_RESTORE_MEDIA_SERVERS information

Usage

Description

Where to use

On NetBackup master servers.

294

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-92

FAILOVER_RESTORE_MEDIA_SERVERS information (continued)

Usage

Description

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
FAILOVER_RESTORE_MEDIA_SERVERS = failed_host host1 host2 ...
hostN

failed_host is the server that is not operational.

host1 ... hostN are the servers that provide failover capabilities.

The default is that NetBackup does not perform automatic failover.

When automatic failover is necessary for a server, NetBackup searches from left to
right through the associated FAILOVER_RESTORE_MEDIA_SERVERS list. It stops when
it finds one that is eligible to perform the restore.

Note: The configuration file can contain multiple

FAILOVER_RESTORE_MEDIA_SERVERS entries and each entry can list multiple servers.
However, a NetBackup server can be a failed_host in only one option.
After a FAILOVER_RESTORE_MEDIA_SERVERS option is added, stop and restart the
NetBackup Request daemon on the master server where you plan to change the
configuration.
Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server >
Restore Failover.
See Restore Failover properties on page 218.

FORCE_RESTORE_MEDIA_SERVER option for NetBackup servers

This option forces the restore to go to a specific server, regardless of where the
files were backed up.
Table 3-93

FORCE_RESTORE_MEDIA_SERVER information

Usage

Description

Where to use

On NetBackup master servers.

295

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-93

FORCE_RESTORE_MEDIA_SERVER information (continued)

Usage

Description

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
FORCE_RESTORE_MEDIA_SERVER = from_host to_host
Where from_host is the server that performed the original backup and to_host is the
server to use for the restore.
Stop and restart the NetBackup Request daemon on the master server after adding
the FORCE_RESTORE_MEDIA_SERVER option. Physically move the media to to_host
before attempting a restore. Update the Media Manager volume database to reflect
the move.
This setting applies to all storage units on the original server. Restores for any storage
unit on from_host go to to_host. To revert to the original configuration for future restores,
delete the option.

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server >
General Server > Media Host Override.
See General Server properties on page 154.

GENERATE_ENGLISH_LOGS option for NetBackup servers and

clients
This option enables the generation of an English error log, and English trace logs
for the bparchive, bpbackup, bpduplicate, bpimport, and bprestore commands.
This option is useful to support personnel to assist in distributed environments
where different locales result in logs that contain various languages.
An English text error log (indicated by the suffix _en) is created in the following
directory:

On Windows: Install_path\Veritas\NetBackup\db\error

On UNIX: /usr/openv/netbackup/db/error

Table 3-94

GENERATE_ENGLISH_LOGS information

Usage

Description

Where to use

On NetBackup master servers or clients.

296

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-94

GENERATE_ENGLISH_LOGS information (continued)

Usage

Description

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
GENERATE_ENGLISH_LOGS
This entry should appear only once in the configuration file.
Setting the GENERATE_ENGLISH_LOGS option also forces the -en argument on the
execution of the following commands when the progress log is specified (-L):
bparchive, bpbackup, bpduplicate, bpimport, and bprestore.
The suffix _en indicates the English text progress log.

Equivalent Administration
Console property

No equivalent exists in the NetBackup Administration Console host properties.

INCOMPLETE_JOB_CLEAN_INTERVAL option for NetBackup

servers and clients
This option indicates the number of days a failed restore job can remain in the
incomplete state before it is moved to the done state.
Table 3-95

INCOMPLETE_JOB_CLEAN_INTERVAL information

Usage

Description

Where to use

On NetBackup master servers or clients.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
INCOMPLETE_JOB_CLEAN_INTERVAL = number_of_days
The default is 7 days.
Where x is a value between 0 and 365. A value of 0 indicates that failed, incomplete
jobs are never automatically moved to the done state.
This entry should appear only once in the configuration file.

297

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-95

INCOMPLETE_JOB_CLEAN_INTERVAL information (continued)

Usage

Description

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server or client
> Clean-up > Move restore job from incomplete state to done state.
See Clean-up properties on page 89.

INITIAL_BROWSE_SEARCH_LIMIT option for NetBackup servers

and clients
This option specifies the number of days back that NetBackup searches for files to
restore.
Table 3-96

INITIAL_BROWSE_SEARCH_LIMIT information

Usage

Description

Where to use

On NetBackup master servers or clients.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
INITIAL_BROWSE_SEARCH_LIMIT = number_of_days
The default is that NetBackup includes files from the time of the last full backup through
the latest backup for the client. If the client belongs to more than one policy the browse
starts with the earliest of the set of last full backups.
This entry should appear only once in the configuration file.
When this option is specified on a UNIX client, it applies only to that client. The option
can reduce the size of the Search window from what is specified on the server (the
client setting cannot make the window larger).

Example

The following example limits the browse range to the seven days before the current
date.
INITIAL_BROWSE_SEARCH_LIMIT = 7

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server >
Universal Settings > Browse timeframe for restores.
See Universal Settings properties on page 253.

298

Configuring Host Properties

Configuration options for NetBackup servers

IP_ADDRESS_FAMILY option for NetBackup servers

The IP_ADDRESS_FAMILY option indicates whether NetBackup on this host supports
only IPv4 or both IPv4 and IPv6.
If any of the SERVER entries do not support IPv4, NetBackup uses the setting that
indicates both IPv4 and IPv6.
Table 3-97

IP_ADDRESS_FAMILY information

Usage

Description

Where to use

On NetBackup servers or clients.

How to use

On the hosts that use both IPv4 and IPv6, use this option to indicate which address
family to use.
Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
IP_ADDRESS_FAMILY = AF_INET | AF_UNSPEC
AF_INET indicates that the host supports only IPv4.
AF_UNSPEC indicates that the host supports both IPv4 and IPv6.
This entry should appear only once in the configuration file.

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server >
Network Settings.
See Network Settings Properties on page 192.

JOB_PRIORITY option for NetBackup servers and clients

Use this option to set the priority for a job type.
Table 3-98

JOB_PRIORITY information

Usage

Description

Where to use

On NetBackup master servers or clients.

299

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-98

JOB_PRIORITY information (continued)

Usage

Description

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
JOB_PRIORITY = P1 P2 P3 P4 P5 P6 P7 P8 P9 P10 P11
P12 P13 P14 P15 P16 P17 P18 P19 P20 P21 P22 P23 P24
Variables P1, P2, and so on indicate the priority for each backup type.
Table 3-99 shows the default priority values.
The actual default values for the option appear as follows:
JOB_PRIORITY = 0 0 90000 90000 90000 90000 85000 85000
80000 80000 80000 80000 75000 75000 70000 70000 50000
50000 0 0 0 0 0 0
This entry should appear only once in the configuration file.

Example

To give backup jobs a priority of 50000 and duplication jobs a priority of 30000, change
the JOB_PRIORITY entry as follows:
JOB_PRIORITY = 50000 0 90000 90000 90000 90000 85000 85000
80000 80000 80000 80000 75000 75000 70000 70000 30000
50000 0 0 0 0 0 0

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server or client
> Default Job Priorities > Job Priority.
See Default Job Priorities properties on page 122.

Table 3-99 lists the order of the job types and the various job type defaults.
Table 3-99

Default job type priorities

Field

Represents this action

Default

P1

Performing a backup

P2

Performing a database backup (a catalog backup) 0

P3

Performing a restore

90000

P4

Recovering a catalog

90000

300

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-99

Default job type priorities (continued)

Field

Represents this action

Default

P5

Performing a staging operation

90000

P6

Performing the duplication jobs that Vault starts

90000

P7

Cleaning up images

85000

P8

Importing images

85000

P9

Requesting tapes

80000

P10

Cleaning a tape

80000

P11

Tape formatting

80000

P12

Performing device diagnostics

80000

P13

Verifying an image

75000

P14

Running a media contents report

75000

P15

Labeling tape media

70000

P16

Erasing media

70000

P17

Running a duplication job

50000

P18

Performing an inventory

50000

P19

This field is not currently in use

P20

This field is not currently in use

P21

This field is not currently in use

P22

This field is not currently in use

P23

This field is not currently in use

P24

This field is not currently in use

LIMIT_BANDWIDTH option for NetBackup servers

This option specifies a limit for the network bandwidth that NetBackup clients use
on a network. The actual limiting occurs on the client side of the backup connection.
This option limits only backups. Restores are unaffected. The default is that the
bandwidth is not limited.

301

Configuring Host Properties

Configuration options for NetBackup servers

Note: LIMIT_BANDWIDTH applies only to IPv4 networks. Use the THROTTLE_BANDWIDTH

option to limit IPv6 networks.
See Throttle Bandwidth properties on page 249.

MEDIA_UNMOUNT_DELAY option for NetBackup servers

When MEDIA_UNMOUNT_DELAY is specified, the media unload is delayed for the
specified number of seconds after the requested operation has completed. (Applies
only to user operations.)
Table 3-100

MEDIA_UNMOUNT_DELAY information

Usage

Description

Where to use

On NetBackup master servers.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
MEDIA_UNMOUNT_DELAY = seconds
The default is a media mount delay time of 180 seconds.
This entry should appear only once in the configuration file.

Example

The delay is set to 120 seconds in the following example:

MEDIA_UNMOUNT_DELAY = 120

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server > Media
> Media unmount delay.
See Media properties on page 182.

MEDIA_REQUEST_DELAY option for NetBackup servers

This option specifies the number of seconds that NetBackup waits for a non-robotic
drive to become ready.
Table 3-101

MEDIA_REQUEST_DELAY information

Usage

Description

Where to use

On NetBackup master servers.

302

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-101

MEDIA_REQUEST_DELAY information (continued)

Usage

Description

How to use

Change the MEDIA_REQUEST_DELAY by using the nbemmcmd command.

See the NetBackup Commands Reference Guide.
The default is that NetBackup does not wait for non-robotic drives to become ready.
This option should appear only once in the configuration file.

Example

The following command indicates to NetBackup to wait 150 seconds for a non-robotic
drive to become ready for use.
nbemmcmd -changesetting -MEDIA_REQUEST_DELAY 150

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server > Media
> Media request delay.
See Media properties on page 182.

MEDIA_SERVER option for NetBackup servers

This option is similar to the SERVER option.
A host that is listed as a MEDIA_SERVER can back up and restore clients. However,
if the host is not specified as a SERVER, the host has limited administrative
capabilities.
Table 3-102

MEDIA_SERVER information

Usage

Description

Where to use

On NetBackup master servers.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
MEDIA_SERVER = media_server_name

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server >
Servers > Media Servers.
See Servers properties on page 229.

303

Configuring Host Properties

Configuration options for NetBackup servers

MPX_RESTORE_DELAY option for NetBackup servers

This option applies to multiplexed restores. The MPX_RESTORE_DELAY specifies how
long the server waits for restore requests of files and raw partitions. In this case,
the option applies to the files and raw partitions in a set of multiplexed images on
the same tape. All of the restore requests that are received within the delay period
are included in the same restore operation (one pass of the tape).
Table 3-103

MPX_RESTORE_DELAY information

Usage

Description

Where to use

On NetBackup master servers.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
MPX_RESTORE_DELAY = seconds
The default is 30 seconds.
This option should appear only once in the configuration file.

Example

The following example configures a server to wait 15 minutes.

MPX_RESTORE_DELAY = 900

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server >
General Server > Delay on multiplexed restores.
See General Server properties on page 154.

MUST_USE_LOCAL_DRIVE option for NetBackup servers

This option instructs NetBackup that if the client is also a media server and this
option is present, backups for this client must occur on a local drive. If all drives are
down, another may be used. If the client is not a media server, this option has no
effect.
Table 3-104

MUST_USE_LOCAL_DRIVE information

Usage

Description

Where to use

On NetBackup master servers.

304

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-104

MUST_USE_LOCAL_DRIVE information (continued)

Usage

Description

How to use

Use the nbemmcmd command to change the option. For example:

nbemmcmd -changesetting -MUST_USE_LOCAL_DRIVE yes
See the NetBackup Commands Reference Guide.
This option should appear only once in the configuration file.

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server >
General Server > Must use local drive.
See General Server properties on page 154.

NBRNTD_IDLE_TIMEOUT option for NetBackup servers

The NBRNTD_IDLE_TIMEOUT option specifies the number of seconds to wait before
the Remote Network Transport Service (nbrntd) shuts itself down. The Remote
Network Transport Service provides resilient network connections. After it is shut
down, NetBackup must restart the service if a new resilient connection for backups
or restores is required.
Table 3-105

NBRNTD_IDLE_TIMEOUT information

Usage

Description

Where to use

On NetBackup master servers.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
NBRNTD_IDLE_TIMEOUT = seconds
The default timeout is 300 seconds (five minutes).
By default, this entry is not present in the configuration file.

Example

In the following example, the Remote Network Transport Service shuts off after 15
minutes.
NBRNTD_IDLE_TIMEOUT = 900

See RESILIENT_NETWORK option for NetBackup master servers and clients

on page 311.

305

Configuring Host Properties

Configuration options for NetBackup servers

PREFERRED_NETWORK option for NetBackup servers

The PREFERRED_NETWORK option replaces the REQUIRED_INTERFACE and
REQUIRED_NETWORK entries.
The PREFERRED_NETWORK option is not needed in an environment if NetBackup is
configured with appropriate host names. The operating system must resolve to the
correct IP addresses and then route the addresses correctly.
When external constraints prevent the environment from being corrected,
PREFERRED_NETWORK entries can be useful in the following situations:

To prevent NetBackup from connecting to specific destination addresses.

To cause NetBackup to connect only to specific destination addresses.

To request a subset of local interfaces for source binding when outbound

connections are made.

Table 3-106

PREFERRED_NETWORK information

Usage

Description

Where to use

On NetBackup servers or clients.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
The option uses the following syntax:
PREFERRED_NETWORK = target[/subnet] directive source[/subnet]

The target[/subnet] is a host name or range of addresses to be compared to the

prospective source or destination addresses being evaluated. The following are
examples of how to indicate a target or a subnet:

A host name: myserver.domain

An IP address: 10.82.105.11

A network with subnet: 10.82.105.0/21

Any IPv4 address: 0.0.0.0

Any IPv6 address: 0::0

Any address: 0/0

Note: A host or a network name that cannot resolve causes the target to be ignored.
However, any associated source is added to the source binding list.

306

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-106
Usage

PREFERRED_NETWORK information (continued)

Description
The directive (MATCH, ONLY, or PROHIBITED) determines how the target is
compared to the source or the destination address that is under evaluation.

MATCH

This directive applies to destination addresses. If the address being evaluated

matches the target, then the address is immediately selected to be used and
evaluation stops. If a target is not matched, evaluation continues with the next
entry.
ONLY

This directive applies to destination addresses. If the address under evaluation

does not match a target, it is not used and evaluation stops for this address. If
the destination is the only potential destination, the connection is not attempted. If
there is an additional potential destination, it is evaluated starting over with the first
entry.
PROHIBITED
The target applies to both source and destination addresses. If a source is
specified, it is ignored and the target is still prohibited.
If the matched address is a destination address, evaluation stops. If the matched
address was the only potential destination, no connection is attempted. If there are
additional potential destinations, they are evaluated starting over with the first entry.
If the matched address is a source address, it is removed from the binding list. If
source entries exist, the shortened binding list may not be used. On some
platforms, prohibiting a local interface may cause unexpected results when
NetBackup connects to remote hosts. Prohibiting a local interface does not affect
the connections that are internal to the host.

Indicating a source[/subnet] is optional. This is a host name or IP address range

that is requested to be used as the local interface for outbound connection to addresses
in target. The source applies to the directives ONLY and MATCH, but not to the
directive PROHIBITED.
Notes:

Equivalent Administration
Console property

The operating system may not honor the source request.

NetBackup does not request a source which has already been PROHIBITED.

A host or a network name that cannot be resolved is ignored, but the evaluation
status of the target is still used.

NetBackup Management > Host Properties > Double-click on master server >
Preferred Network.
See Preferred Network properties on page 197.

307

Configuring Host Properties

Configuration options for NetBackup servers

The following Support document contains more information about using the
PREFERRED_NETWORK option:
http://www.symantec.com/docs/HOWTO60779

Examples of the PROHIBITED directive

An example that prevents the host from using IPv4 addresses:

PREFERRED_NETWORK = 0.0.0.0 PROHIBITED

An example that prevents the host from using IPv6 addresses:

PREFERRED_NETWORK = 0::0 PROHIBITED

This example prevents the host from using the address of the production_server:
PREFERRED_NETWORK = production_server PROHIBITED

This example prevents NetBackup from using any address between 12.34.0.0
and 12.34.255.255 as the source or destination for a connection. If it matches
a local interface, NetBackup provides an ordered list of the remaining interfaces
as the source binding list for the outbound interface when other entries do not
specify a source. The operating system may always use the first one in the list
instead of using the network routing tables to select the best one.
PREFERRED_NETWORK = 12.34.56.78/16 PROHIBITED

Examples of the ONLY directive

This example instructs the host to use only IPv6 addresses in that subnet range:
PREFERRED_NETWORK = 2001:1234:1efc::/48 ONLY

This example prevents NetBackup from connecting to any destination address

outside the range of 12.34.56.0 to 12.34.56.255. The entry does not affect
outbound interface selection.
PREFERRED_NETWORK = 12.34.56.78/24 ONLY

This example prevents NetBackup from connecting to any destination address

outside the range of 12.34.56.0 to 12.34.56.255. The entry requests that the
operating system use 98.76.54.32 as the outbound interface.
PREFERRED_NETWORK = 12.34.56.78/24 ONLY 98.76.54.32

308

Configuring Host Properties

Configuration options for NetBackup servers

Examples of the MATCH directive

This example instructs the host to use the interface IPs of Host_A for all IPv4
and IPv6 addresses. The entry can appear multiple times in the configuration
file.
PREFERRED_NETWORK

= 0/0 MATCH Host_A

This example allows connectivity to the host names that resolve to 12.34.0.0 to
12.23.255.255. The entry does not affect outbound interface selection:
PREFERRED_NETWORK = 12.34.0.0/16 MATCH

This example allows connectivity to the host name that resolves to 12.34.56.78,
and requests that the operating system use 98.76.54.32 as the outbound
interface:
PREFERRED_NETWORK = 12.34.56.78 MATCH 98.76.54.32

RANDOM _PORTS option for NetBackup servers and clients

This option specifies whether NetBackup chooses port numbers randomly or
sequentially when it requires one for communication with NetBackup on other
computers.
Table 3-107

RANDOM _PORTS information

Usage

Description

Where to use

On NetBackup master servers or clients.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.

If RANDOM_PORTS = YES (default), NetBackup chooses port numbers randomly

from those that are free in the allowed range. For example, if the range is from 1024
through 5000, it chooses randomly from the numbers in this range.
If RANDOM_PORTS = NO, NetBackup chooses numbers sequentially, starting with
the highest number available in the allowed range. For example, if the range is from
1024 through 5000, NetBackup chooses 5000 (if the number is available). If 5000
is not available, port 4999 is chosen.

By default, this option is not present in the configuration file and NetBackup uses the
random method for selecting port numbers.

309

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-107

RANDOM _PORTS information (continued)

Usage

Description

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server > Port
Ranges > Use random port assignments.
See Port Ranges properties on page 194.

RE_READ_INTERVAL option for NetBackup servers

The RE_READ_INTERVAL option determines how often NetBackup checks disk storage
units for available capacity.
Table 3-108

RE_READ_INTERVAL information

Usage

Description

Where to use

On NetBackup master servers.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
RE_READ_INTERVAL = seconds
The default is 300 seconds (5 minutes).
This entry should appear only once in the configuration file.

Example

The reread interval is changed to 15 minutes in the following example:

RE_READ_INTERVAL = 900

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server >
General Server > Check the capacity of disk storage units.
See General Server properties on page 154.

REQUIRED_NETWORK option for NetBackup servers

The REQUIRED_NETWORK option specifies the required route for backup traffic in an
environment where the network traffic is segregated.
For example, an environment can contain a production network at 145.21.14.0
and a backup network at 192.132.28.0.

310

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-109

REQUIRED_NETWORK information

Usage

Description

Where to use

On NetBackup master servers.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
REQUIRED_NETWORK = IP_address
This entry should appear only once in the configuration file.

Note: If the variable is set and the network is not available, all connections fail and no
backups are performed.
Example

The required network is set to 192.132.28.0 in the following example:

REQUIRED_NETWORK = 192.132.28.0

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server >
Preferred Network > Only.
See Preferred Network properties on page 197.

RESILIENT_NETWORK option for NetBackup master servers and

clients
The RESILIENT_NETWORK option specifies the computers that should use a resilient
connection for backups and restores.
Table 3-110

RESILIENT_NETWORK information

Usage

Description

Where to use

On NetBackup master servers or clients.

311

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-110

RESILIENT_NETWORK information (continued)

Usage

Description

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use any of the following formats:
RESILIENT_NETWORK = hostname ON|OFF
RESILIENT_NETWORK = ip_address ON|OFF
RESILIENT_NETWORK = network address/network_mask ON|OFF
You can mix IPv4 addresses and ranges with IPv6 addresses and subnets.
By default, RESILIENT_NETWORK is not present in the configuration file.

Examples

The following are examples of valid forms for this entry:

RESILIENT_NETWORK = client.symantecs.org ON
RESILIENT_NETWORK = 192.0.2.0 ON
RESILIENT_NETWORK = 192.0.2.0/26 OFF
RESILIENT_NETWORK = 2001:db8:0:0:0:0:0:0 ON

Equivalent Administration
Console property

NetBackup Management > Host Properties > Master Servers Double-click on master
server > Resilient Network.
NetBackup Management > Host Properties > Clients Double-click on client >
Resilient Network.
See Specifying resilient connections on page 214.

Note: The order is significant for the items in the list of resilient networks. If a client
is in the list more than once, the first match determines its resilient connection
status. For example, suppose you add a client and specify the client IP address
and specify On for Resiliency. Suppose also that you add a range of IP addresses
as Off, and the client IP address is within that range. If the client IP address appears
before the address range, the client connection is resilient. Conversely, if the IP
range appears first, the client connection is not resilient.
See NBRNTD_IDLE_TIMEOUT option for NetBackup servers on page 305.

312

Configuring Host Properties

Configuration options for NetBackup servers

RESUME_ORIG_DUP_ON_OPT_DUP_FAIL option for NetBackup

servers
The RESUME_ORIG_DUP_ON_OPT_DUP_FAIL option specifies that NetBackup should
perform normal duplication if an OpenStorage optimized duplication fails.
Table 3-111

RESUME_ORIG_DUP_ON_OPT_DUP_FAIL information

Usage

Description

Where to use

On NetBackup master servers.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
RESUME_ORIG_DUP_ON_OPT_DUP_FAIL = TRUE | FALSE
By default, this entry is not present and NetBackup does not perform normal duplication
when an optimized duplication fails.
This entry should appear only once in the configuration file.

Equivalent Administration
Console property

No equivalent exists in the NetBackup Administration Console host properties.

REVERSE_NAME_LOOKUP option for NetBackup servers and

clients
This option lets administrators allow, restrict, or prohibit reverse host name lookup.
Table 3-112

REVERSE_NAME_LOOKUP information

Usage

Description

Where to use

On NetBackup servers or clients.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
REVERSE_NAME_LOOKUP = ALLOWED | RESTRICTED | PROHIBITED
This entry should appear only once in the configuration file.

313

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-112

REVERSE_NAME_LOOKUP information (continued)

Usage

Description

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server >
Network Settings > Reverse Host Name Lookup.
See Network Settings Properties on page 192.

SERVER option for NetBackup servers

The first SERVER option in the bp.conf file must point to the master server where
the bp.conf option resides. During installation, SERVER is automatically set to the
name of the system where the NetBackup master server software is installed.
Table 3-113

SERVER information

Usage

Description

Where to use

On NetBackup master servers and media servers.

Note: For a Fibre Transport (FT) media server that has multiple network interfaces for
VLANs, ensure that the FT servers primary host name appears before any other
interface names for that FT media server host.
For more information, see the NetBackup SAN Client and Fibre Transport Guide.

314

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-113

SERVER information (continued)

Usage

Description

How to use

An entry for the SERVER option must be present in the configuration file on all NetBackup
servers and clients. It is the only required NetBackup option. This option is not used
in $HOME/bp.conf files on a client.
Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.

Note: This topic discusses the bp.conf entries on the server. However, note that
every SERVER option in a client bp.conf file must be a NetBackup master or media
server. That is, each system that is listed as a SERVER must have either NetBackup
master or media server software installed. The client service on some clients cannot
be started if the client name is incorrectly listed as a server.
If you configure NetBackup media servers for a master server, the bp.conf file on
the master server must have a SERVER entry or MEDIA_SERVER entry for each. As
previously mentioned, the first SERVER entry in the list designates the master server
itself. The SERVER entry or the MEDIA_SERVER entries should be added after the first,
self-referencing option.
A NetBackup master server can be backed up as a NetBackup client by the servers
that belong to another cluster. In that case the bp.conf file on the master server
should have SERVER entries for those servers as well.

315

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-113

SERVER information (continued)

Usage

Description

Example

The following is an example entry on a master server:

SERVER = Master_server (this master server itself)
SERVER = NB_server (master server of another cluster)
SERVER = Media_server_#1
MEDIA_SERVER = Media_server_#2
.
.
.
The first SERVER entry on all the media servers must point to the master server for
those media servers. A media server can have only one master server. However, a
media server can be backed up as a NetBackup client by the servers that belong to
another cluster, in which case the configuration file on the media server should have
SERVER entries for those servers as well.
The following is an example entry on a media server:
SERVER = Master_server (for this media server)
SERVER = NB_server (master server of another cluster)
SERVER = Media_server_#1
MEDIA_SERVER = Media_server_#2
.
.
.
The SERVER entries must be the same on all servers in a master and a media server
cluster.
If a SERVER entry is added or modified in the bp.conf file on the master server, stop
and restart bprd and bpdbm so that NetBackup recognizes the change. (The NetBackup
request daemon and NetBackup database manager.)

Note: If the first SERVER entry (the master server) is modified on a media server, the
Enterprise Media Manager (EMM) also needs to be updated. To update EMM, run
nbemmcmd -updatehost to change the master server for a media server.

316

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-113

SERVER information (continued)

Usage

Description

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server >
Servers.
See Servers properties on page 229.
See FAILOVER_RESTORE_MEDIA_SERVERS option for NetBackup servers
on page 294.

SERVER_CONNECT_TIMEOUT option for NetBackup servers

SERVER_CONNECT_TIMEOUT specifies the number of seconds that the master server

waits before it times out when it connects to a media server.

Table 3-114

SERVER_CONNECT_TIMEOUT information

Usage

Description

Where to use

On NetBackup master servers.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
SERVER_CONNECT_TIMEOUT = seconds
The default timeout period is 30 seconds.
This entry should appear only once in the configuration file.

Example

The example permits a timeout of 60 seconds:

SERVER_CONNECT_TIMEOUT = 60

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server >
Timeouts > Server connect timeout.
See Timeouts properties on page 251.

SERVER_PORT_WINDOW option for NetBackup servers

The SERVER_PORT_WINDOW option specifies the range of non-reserved ports on which
NetBackup processes on this computer accept connections from NetBackup on
other computers when the inbound connection is not to a well known port. This

317

Configuring Host Properties

Configuration options for NetBackup servers

primarily applies to bpcd call-back when vnetd is disabled in the connect options
for the remote NetBackup server or client and that host is configured for
non-reserved ports. This also applies to NDMP call-back to the media server during
remote NDMP backups.
Table 3-115

SERVER_PORT_WINDOW information

Usage

Description

Where to use

On NetBackup master servers or media servers.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
SERVER_PORT_WINDOW = start_port end_port
The default range is from 1024 through 5000.
This entry should appear only once in the configuration file.

Example

The following example permits ports from 4900 through 5000:

SERVER_PORT_WINDOW = 4900 5000

Equivalent Administration
Console property

To use the NetBackup Administration Console to configure this option, change the
Server port window range property in the Port Ranges host properties.
NetBackup Management > Host Properties > Double-click on master server > Port
Ranges > Server port window.
See Port Ranges properties on page 194.

SERVER_RESERVED_PORT_WINDOW option for NetBackup

servers and clients
This option specifies the range of local reserved ports on which this computer
accepts connections from NetBackup on other computers when the inbound
connection is not to a well known port. This primarily applies to bpcd call-back when
vnetd is disabled in the connect options for the remote NetBackup server or client.
The SERVER_RESERVED_PORT_WINDOW option applies when a server connects to a
client that is configured to accept only reserved ports. This option is generally not
useful on clients.

318

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-116

SERVER_RESERVED_PORT_WINDOW information

Usage

Description

Where to use

On NetBackup master servers or media servers.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
SERVER_RESERVED_PORT_WINDOW = start_port end_port
The default range is from 512 through 1023.
This entry should appear only once in the configuration file.

Example

The following example permits ports from 900 through 1023:

SERVER_RESERVED_PORT_WINDOW = 900 1023

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server > Port
Ranges > Server reserved port window.
See Port Ranges properties on page 194.

SKIP_RESTORE_TO_SYMLINK_DIR option for NetBackup servers

The SKIP_RESTORE_TO_SYMLINK_DIR option forces NetBackup to check all directories
on a UNIX client into which files are restored. If the file to be restored is under a
symbolically linked directory, NetBackup does not restore the file.
Table 3-117

SKIP_RESTORE_TO_SYMLINK_DIR information

Usage

Description

Where to use

On NetBackup master servers.

319

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-117

SKIP_RESTORE_TO_SYMLINK_DIR information (continued)

Usage

Description

How to use

This option should appear only once in the configuration file.

For example, if the UNIX client requests a restore for /home/user/.cshrc and
/home/user is a symbolic link, NetBackup does not restore .cshrc.
The addition of SKIP_RESTORE_TO_SYMLINK_DIR helps minimize potential security
and data loss problems if the restore is performed with root permissions. Without
SKIP_RESTORE_TO_SYMLINK_DIR in the bp.conf file, NetBackup follows any
symbolically linked directories and restores files to that location.

Note: Restore job performance is reduced by using this option.

SKIP_RESTORE_TO_SYMLINK_DIR and UNLINK_ON_OVERWRITE do not affect each
other if both are specified, with one exception:
When the following options are enabled:

Overwrite existing files option

SKIP_RESTORE_TO_SYMLINK_DIR

UNLINK_ON_OVERWRITE

Then, when a restore job comes across a symbolic link, the link is unlinked before the
job checks, and the files and directory are restored.
For example, /home/user/ is backed up as a directory and, when restored, it is a
symbolic link to a directory.
These settings have the following outcomes:

Equivalent Administration
Console property

With SKIP_RESTORE_TO_SYMLINK_DIR set (and Overwrite existing files

indicated), no files are restored into the directory the symbolic link points to, and
the symbolic link remains.
With both UNLINK_ON_OVERWRITE and SKIP_RESTORE_TO_SYMLINK_DIR (and
Overwrite existing files indicated), the symbolic link directory is unlinked, the
original directory is restored, and all files within the directory are also restored.
With neither option set (and Overwrite existing files indicated), NetBackup follows
the symbolic link and restore all files into the directory to which the symbolic link
points.

NetBackup Management > Host Properties > Double-click on master server > Port
Ranges > Server reserved port window.
See Port Ranges properties on page 194.

TELEMETRY_UPLOAD option for NetBackup servers

TELEMETRY_UPLOAD allows NetBackup to collect data about how the product is used

in a NetBackup environment. The information that Symantec receives becomes

320

Configuring Host Properties

Configuration options for NetBackup servers

part of a continuous quality improvement program (NetBackup Product Improvement

Program) that helps Symantec understand how customers configure, deploy, and
use the NetBackup product. The data is restricted to NetBackup and OpsCenter
development at Symantec.
The telemetry collection agent runs on every NetBackup server, OpsCenter server,
and NetBackup Search Index server. The telemetry collection agent does not run
on NetBackup clients.
Table 3-118

TELEMETRY_UPLOAD information

Usage

Description

Where to use

On NetBackup master servers.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
TELEMETRY_UPLOAD = YES | NO
The default is YES.
This entry should appear only once in the configuration file.

Equivalent Administration
Console property

During the NetBackup or OpsCenter installation process, a prompt or checkbox appears

that asks for the users' agreement to participate in the Product Improvement Program.

THROTTLE_BANDWIDTH option for NetBackup servers

This option specifies a limit for the network bandwidth or transfer rate that NetBackup
clients use on a network. The actual limiting occurs on the client side of the backup
connection. This option limits only backups. Restores are unaffected. The default
is that the bandwidth is not limited.
While LIMIT_BANDWIDTH associates a bandwidth or transfer rate with all client IP
addresses in a range between two IP addresses, THROTTLE_BANDWIDTH is more
useful in an IPv6 environment. THROTTLE_BANDWIDTH associates a bandwidth setting
with a subnet description.
For example, the following subnet will get 400kbs bandwidth:
2001:db8:cb30:120::/64 400

321

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-119

THROTTLE_BANDWIDTH information

Usage

Description

Where to use

On NetBackup master servers.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format in a single line:
THROTTLE_BANDWIDTH = xxxx:xxxx:xxxx:xxxx:
yyyy:yyyy:yyyy:yyyy::/nnn zzz
Each THROTTLE_BANDWIDTH option specifies the bandwidth value and the IP address
of the clients and networks to which it applies.
The following variables are defined:

Bandwidth examples

xxxx.xxxx.xxxx.xxxx is the subnet portion (64-bits) of the IPv6 address range. (For
example, 2001:db8:1:110.)

yyyy.yyyy.yyyy.yyyy is the host portion (64-bits) of the IPv6 address range. (For
example, 0:0:0:8b72.)

nnn is the number of mask bits that, when applied to the IPv6 address, identifies
the range of addresses that are considered for throttling. The valid range is 0 to
128. Mask bits are applied left to right across the address range.

zzz is the bandwidth limitation in kilobytes per second. (For example, 200.) A value
of 0 disables throttling IPv6 addresses covered by this option.

The following are LIMIT_BANDWIDTH examples:

Configure a bandwidth limit of 500 kilobytes per second for all computers on the
subnet 2001:db8:1:110 as follows:
LIMIT_BANDWIDTH = 2001:db8:1:110::/64 500

Configure a bandwidth limit of 700 kilobytes per second for a particular client
(2001:db8:1:110:0:0:0:8b72) as follows:
LIMIT_BANDWIDTH = 2001:db8:1:110:0:0:0:8b72::/128 700

To disable bandwidth limiting for a client in a subnet that has a bandwidth limit,
specify 0 for the kilobytes per second:
LIMIT_BANDWIDTH = 2001:db8:1:110::/64 500
LIMIT_BANDWIDTH = 2001:db8:1:110:0:0:0:8b72::/128 0
In this case, no limiting occurs for the client with IPv6 address
2001:db8:1:110:0:0:0:8b72

322

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-119

THROTTLE_BANDWIDTH information (continued)

Usage

Description

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server >
Bandwidth.
See Bandwidth properties on page 84.

IPv6 address rules for NetBackup clients

The IPv6 address ranges can specify individual clients or entire subnets.

An IPv6 address can take the following forms:

a.b.c.d.

Where a, b, c, and d are hexadecimal integers in the range 0-ffff.

A 32-bit integer that represents the full IP address in network byte order.
(The big endian, the most significant byte is first on the wire.)

Enter IPv6 addresses as hexadecimal numbers.

Neither the subnet nor the host part of an IPv6 address can be zero.

Only ordinary IPv6 addresses are accepted.

Do not create multiple entries that specify the same range of IPv6 addresses.
If multiple entries are created, NetBackup uses the last one found.
In the following example, NetBackup uses the second entry:
LIMIT_BANDWIDTH = 2001:db8:1:110::/48 500
LIMIT_BANDWIDTH = 2001:db8:1:110::/48 200

This rule also applies to multiple entries that specify an exact client address, as
follows:
LIMIT_BANDWIDTH = 2001:db8:1:110:0:0:0:8b72::/128 200
LIMIT_BANDWIDTH = 2001:db8:1:110:0:0:0:8b72::/128 100

Do not specify IPv6 address ranges that overlap one another.

Consider the following:
LIMIT_BANDWIDTH = 2001:db8:1:110::/48 500
LIMIT_BANDWIDTH = 2001:db8:1:110::/48 500

The ranges overlap, and bandwidth limiting results are unpredictable.

323

Configuring Host Properties

Configuration options for NetBackup servers

Specify a range of addresses in one entry and an address for a specific client
in other entries.
If a client is covered by an entry that specifies its exact IPv6 address and by
another entry that specifies a range of IPv6 addresses, NetBackup uses the
bandwidth value in the entry with the exact IP address.
The following sets the bandwidth for a range of IPv6 addresses:
LIMIT_BANDWIDTH = 2001:db8:1:110::/48 500

The following sets the bandwidth for a specific address that is within the range:
LIMIT_BANDWIDTH = 2001:db8:1:110:0:0:0:8b72::/128 200

In this case, NetBackup uses the specific entry (bandwidth of 200) for the client
whose address is 2001:db8:1:110:0:0:0:8b72. This capability can also be used
to exclude specific clients from bandwidth limiting. The order of the range and
specific address entries in the bp.conf file is not significant.

Rules for setting bandwidth values for NetBackup clients

Set bandwidths for individual clients to one of the following values:

0 (no bandwidth limiting), or

Less than or equal to any value that is set for the IPv6 address range that
contains the IP address for the client.
For example, the following is valid:
LIMIT_BANDWIDTH = 2001:db8:1:110:0:0:0:8b72::/64 500
LIMIT_BANDWIDTH = 2001:db8:1:110:0:0:0:8b72::/128 300

If the bandwidth is set higher for a client than is set for the range, NetBackup ignores
the individual setting. NetBackup uses the value for the range instead. In this case,
the client receives a share of the bandwidth that is specified for the network.
If the bandwidth limit for a client is equal to or lower than the value for the range,
the client uses the lower of the following settings:

Its share of the network bandwidth value.

Its individual bandwidth value.

The bandwidth value that NetBackup uses for a client is always at least one kilobyte
per second.

324

Configuring Host Properties

Configuration options for NetBackup servers

TRUSTED_MASTER option for NetBackup servers

The TRUSTED_MASTER option lets administrators indicate a specific storage lifecycle
policy in a target master server domain to configure Auto Image Replication. The
ability to replicate to a specific target domain SLP is supported between MSDP
storage servers and PDDO storage servers.
Table 3-120

TRUSTED_MASTER information

Usage

Description

Where to use

On NetBackup master servers or media servers.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Add TRUSTED_MASTER on the master server in the source domain and the master
server in the target domain.

Example

On the source domain master server, enter the name of the target master server:
TRUSTED_MASTER = Target_Server_Name
On the target domain master server, enter the name of the source master server:
TRUSTED_MASTER = Source_Server_Name

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server >
Servers > Inter-domain Master Servers tab.
See Servers properties on page 229.
See Configuring a target for MSDP replication to a remote domain on page 1000.

ULINK_ON_OVERWRITE option for NetBackup servers

When a UNIX client indicates Overwrite existing files as a restore option, the
UNLINK_ON_OVERWRITE option forces NetBackup to perform the following actions:

Check for the existence of a file to be restored.

Unlink the file if it exists.

Restore the file.

The file can be any normal file, symbolic link, hard link, or empty directory.
The addition of UNLINK_ON_OVERWRITE helps minimize potential security and data
loss problems from following existing symbolic links. It also guarantees that files
are restored exactly as they were backed up.

325

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-121

ULINK_ON_OVERWRITE information

Usage

Description

Where to use

On NetBackup master servers.

How to use

This option should appear only once in the configuration file.

Note: Restore job performance is reduced by using this option.

If the UNLINK_ON_OVERWRITE option is not indicated in the bp.conf file but the
Overwrite existing files option is specified, the behavior of NetBackup is different
when it restores symbolic links. (Or, if the option is set to NO.) NetBackup unlinks
existing files or empty directories when it restores symbolic links, hard links, or special
files (CHR, BLK, and FIFO).
However, NetBackup does not unlink when it restores normal files or directories, which
can be problematic. NetBackup follows the symbolic link and creates or replaces the
files that the symbolic link points to. Or, it replaces the directory that the symbolic link
points to.
SKIP_RESTORE_TO_SYMLINK_DIR and UNLINK_ON_OVERWRITE do not affect
each other if both are specified, with one exception:
When the following options are enabled:

Overwrite existing files option

SKIP_RESTORE_TO_SYMLINK_DIR

UNLINK_ON_OVERWRITE

Then, when a restore job comes across a symbolic link, the link is unlinked before the
job checks, and the files and directories are restored.
Example

For example, if the /home/user/ path was backed up as a directory and, when restored,
it is a symbolic link to a directory:

Equivalent Administration
Console property

With SKIP_RESTORE_TO_SYMLINK_DIR set (and Overwrite existing files

indicated), no files are restored into the directory the symbolic link points to, and
the symbolic link remains.
With both UNLINK_ON_OVERWRITE and SKIP_RESTORE_TO_SYMLINK_DIR (and
Overwrite existing files indicated), the symbolically linked directory is unlinked,
the original directory is restored, and all files within the directory are also restored.
With neither set (and Overwrite existing files indicated), NetBackup follows the
symbolic link and restore all files into the directory the symbolic link points to.

No equivalent exists in the NetBackup Administration Console host properties.

326

Configuring Host Properties

Configuration options for NetBackup servers

USE_VXSS option for NetBackup servers and clients

The USE_VXSS option specifies whether the local system uses NetBackup product
authentication and authorization.
Table 3-122

USE_VXSS information

Usage

Description

Where to use

On NetBackup master servers or clients.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
USE_VXSS = REQUIRED | PROHIBITED | AUTOMATIC
The option uses the following parameters:

REQUIRED

Indicates that the local system always uses NetBackup product authentication and
authorization. Connections from the systems that do not use NetBackup product
authentication and authorization are rejected.
PROHIBITED

(Default.) Indicates that the local system never uses NetBackup product
authentication and authorization. Connections from the systems that use NetBackup
product authentication and authorization are rejected.
AUTOMATIC
Indicates that the local system negotiates with the remote system whether to use
NetBackup product authentication and authorization.
If the USE_VXSS = AUTOMATIC option is specified, VXSS_NETWORK entries can
be used to require or prohibit NetBackup product authentication and authorization
connections with specified remote systems.
See VXSS_NETWORK option for NetBackup servers on page 328.

This entry should appear only once in the configuration file.

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server > Access
Control > NetBackup product authentication and authorization. Change this option
to Required.
See Network Attributes tab of the Access Control properties on page 77.

327

Configuring Host Properties

Configuration options for NetBackup servers

VERBOSE option for NetBackup servers and clients

Used for debugging purposes, the VERBOSE option controls the amount of information
NetBackup includes in its legacy logs.
Table 3-123

VERBOSE information

Usage

Description

Where to use

On NetBackup master servers or clients.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
VERBOSE = [ 0 | 1 | 2 | 3 | 4 | 5 ]
By default, this option is disabled.
This option should appear only once in the configuration file.

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server >
Logging > Global logging level.
See Logging properties on page 169.

VXSS_NETWORK option for NetBackup servers

This option identifies whether a specific network or remote system must or must
not use NetBackup product authentication and authorization with the local
system.
If a media server or client does not define a NetBackup product authentication
and authorization network, it uses the NetBackup product authentication and
authorization networks of its master server.
Table 3-124

VXSS_NETWORK information

Usage

Description

Where to use

On NetBackup master servers.

328

Configuring Host Properties

Configuration options for NetBackup servers

Table 3-124

VXSS_NETWORK information (continued)

Usage

Description

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
For information about these commands, see the NetBackup Commands Reference
Guide.
Use the following format:
VXSS_NETWORK = hostname | IP_address | .domain | network.
[AUTOMATIC | REQUIRED | PROHIBITED]
VXSS_NETWORK is relevant only if USE_VXSS is set to AUTOMATIC (USE_VXSS =
AUTOMATIC). More than one VXSS_NETWORK option can be specified.
See USE_VXSS option for NetBackup servers and clients on page 327.
The option uses the following parameters:

hostname

The host name of the remote system.

IP_address

The IP address of the remote system.

.domain

A dot followed by the Internet domain name of the remote systems.

network.
The network for the remote systems, followed by a dot.

The optional second value can be one of the following keywords:

AUTOMATIC

REQUIRED

PROHIBITED

Note: If multiple VXSS_NETWORK entries specify one particular system, the first
occurrence takes precedence.

329

Configuring Host Properties

Configuration options for NetBackup clients

Table 3-124

VXSS_NETWORK information (continued)

Usage

Description

Example

USE_VXSS = AUTOMATIC
VXSS_NETWORK = fred.mycompany.com
VXSS_NETWORK = 10.0.0.37 REQUIRED
VXSS_NETWORK = 10.0.0. PROHIBITED
VXSS_NETWORK = .theircompany.com
VXSS_NETWORK = wilma.theircompany.com PROHIBITED
VXSS_NETWORK = barney.mycompany.com PROHIBITED
In the example, NetBackup product authentication and authorization is required
for connections between the local system and the system with host
fred.mycompany.com.
NetBackup product authentication and authorization is required for connections
between the local system and the system with IP address 10.0.0.37.
NetBackup product authentication and authorization is prohibited for connections
between the local system and systems in the 10.0.0 network except for 10.0.0.37.
NetBackup product authentication and authorization is required for connections
between the local system and systems within the theircompany.com Internet domain.
NetBackup product authentication and authorization is required for connections
between the local system and the system with host name wilma.theircompany.com
despite the PROHIBITED option for wilma.theircompany.com. The REQUIRED
option for .theircompany.com takes precedence.
NetBackup product authentication and authorization is prohibited for connections
between the local system and the system with host name barney.mycompany.com

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on master server > Access
Control. Change the networks list property.
See Network Attributes tab of the Access Control properties on page 77.

Configuration options for NetBackup clients

The following topics are about configuration options for NetBackup clients. Nearly
all of these options can also be set in the Host Properties in the NetBackup
Administration Console.
See Configuration options not found in the Host Properties on page 261.

330

Configuring Host Properties

Configuration options for NetBackup clients

BPARCHIVE_POLICY option for NetBackup clients

The BPARCHIVE_POLICY entry specifies the name of the policy to use for user
archives.
Table 3-125

BPARCHIVE_POLICY information

Usage

Description

Where to use

On NetBackup clients.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
Use the following format:
BPARCHIVE_POLICY = policy_name
By default, BPARCHIVE_POLICY is not present in the configuration file. By default,
NetBackup uses the first policy that it finds that has the client and a user archive
schedule.
If it is used, this option should appear only once in the configuration file.
The value in the users $HOME/bp.conf file takes precedence, if it exists.
See Type of backup (schedule attribute) on page 732.

Equivalent Administration
Console property

No equivalent exists in the NetBackup Administration Console host properties.

BPARCHIVE_SCHED option for NetBackup clients

This entry specifies the name of the schedule for user archives.
Table 3-126

BPARCHIVE_SCHED information

Usage

Description

Where to use

On NetBackup clients.

331

Configuring Host Properties

Configuration options for NetBackup clients

Table 3-126

BPARCHIVE_SCHED information (continued)

Usage

Description

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
Use the following format:
BPARCHIVE_SCHED = schedule_name
By default, BPARCHIVE_SCHED is not present in the configuration file. By default,
NetBackup uses the first archive schedule in the first policy that it finds that contains
this client.
If it is used, this option should appear only once in the configuration file.
The value in the users $HOME/bp.conf file takes precedence if it exists.
See Considerations for user schedules on page 740.

Equivalent Administration
Console property

No equivalent exists in the NetBackup Administration Console host properties.

BPBACKUP_POLICY option for NetBackup clients

This entry specifies the name of the policy to use for user backups.
Table 3-127

BPBACKUP_POLICY information

Usage

Description

Where to use

On NetBackup clients.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
Use the following format:
BPBACKUP_POLICY = policy_name
By default, BPBACKUP_POLICY is not present in the configuration file. By default,
NetBackup uses the first policy it finds that has both the client and a user backup
schedule.
If present, this option should appear only once in the configuration file.
The value in the users $HOME/bp.conf file takes precedence if it exists.
See Type of backup (schedule attribute) on page 732.

Equivalent Administration
Console property

No equivalent exists in the NetBackup Administration Console host properties.

332

Configuring Host Properties

Configuration options for NetBackup clients

BPBACKUP_SCHED option for NetBackup clients

This entry specifies the name of the schedule to use for user backups.
Table 3-128

BPBACKUP_SCHED information

Usage

Description

Where to use

On NetBackup clients.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
Use the following format:
BPBACKUP_SCHED = schedule_name
By default, BPBACKUP_SCHED is not present in the configuration file. By default,
NetBackup uses the first policy it finds that contains both the client and a user backup
schedule.
If present, this option should appear only once in the configuration file.
The value in the users $HOME/bp.conf file takes precedence if it exists.
See Considerations for user schedules on page 740.

Equivalent Administration
Console property

No equivalent exists in the NetBackup Administration Console host properties.

BUSY_FILE_ACTION option for NetBackup clients

The BUSY_FILE_ACTION entry directs the action that NetBackup performs on busy
files when busy-file processing is enabled.
Table 3-129

BUSY_FILE_ACTION information

Usage

Description

Where to use

On NetBackup clients.

333

Configuring Host Properties

Configuration options for NetBackup clients

Table 3-129

BUSY_FILE_ACTION information (continued)

Usage

Description

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
BUSY_FILE_ACTION = filename_template action_template

filename_template
The absolute pathname and file name of the busy file. The shell language
metacharacters *, ?, [], [ - ] can be used for matching patterns of file names or parts
of file names.

action_template
Use one of the following parameters:
MAIL | mail
Directs NetBackup to email a busy file notification message to the user that the
BUSY_FILE_NOTIFY_USER option specifies.

REPEAT | repeat [repeat_count]

Directs NetBackup to retry the backup on the specified busy file. A repeat count
can be specified to control the number of backup attempts. The default repeat
count is 1.
IGNORE | ignore
Directs NetBackup to exclude the busy file from processing.

Multiple BUSY_FILE_ACTION entries are allowed.

The value in the users $HOME/bp.conf file takes precedence if it exists.
Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on client > Busy File
Settings.
See Busy File Settings properties on page 86.

BUSY_FILE_DIRECTORY option for NetBackup clients

The BUSY_FILE_DIRECTORY entry specifies the path to the busy-files working directory
when busy-file processing is enabled.
Table 3-130

BUSY_FILE_DIRECTORY information

Usage

Description

Where to use

On NetBackup clients.

334

Configuring Host Properties

Configuration options for NetBackup clients

Table 3-130

BUSY_FILE_DIRECTORY information (continued)

Usage

Description

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
Use the following format:
BUSY_FILE_DIRECTORY = pathname
By default, BUSY_FILE_DIRECTORY is not present in the configuration file. By default,
NetBackup creates the busy_files directory in /usr/openv/netbackup.
If present, this option should appear only once in the configuration file.
The value in the users $HOME/bp.conf file takes precedence, if it exists.

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on client > Busy File
Settings.
See Busy File Settings properties on page 86.

BUSY_FILE_NOTIFY_USER option for NetBackup clients

The BUSY_FILE_NOTIFY_USER entry specifies who receives a notification when the
BUSY_FILE_ACTION entry is set to MAIL.
Table 3-131

BUSY_FILE_NOTIFY_USER information

Usage

Description

Where to use

On NetBackup clients.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
Use the following format:
BUSY_FILE_NOTIFY_USER = email
By default, BUSY_FILE_NOTIFY_USER is not present in the configuration file. By
default, the email recipient is root.
If present, this option should appear only once in the configuration file.
The value in the users $HOME/bp.conf file takes precedence, if it exists.

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on client > Busy File
Settings.
See Busy File Settings properties on page 86.

335

Configuring Host Properties

Configuration options for NetBackup clients

BUSY_FILE_PROCESSING option for NetBackup clients

The BUSY_FILE_PROCESSING entry lets the administrator control what NetBackup
does when a file changes while it is in the process of being backed up.
Table 3-132

BUSY_FILE_PROCESSING information

Usage

Description

Where to use

On NetBackup clients.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
Use the following format:
BUSY_FILE_PROCESSING = yes
By default, BUSY_FILE_PROCESSING is not present in the configuration file and
busy-file processing does not occur.
If present, this option should appear only once in the configuration file.

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on client > Busy File
Settings.
See Busy File Settings properties on page 86.

CLIENT_NAME option for NetBackup clients

The CLIENT_NAME entry specifies the name of the client as it is known to NetBackup.
Table 3-133

CLIENT_NAME information

Usage

Description

Where to use

On NetBackup clients.

336

Configuring Host Properties

Configuration options for NetBackup clients

Table 3-133

CLIENT_NAME information (continued)

Usage

Description

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
Use the following format:
CLIENT_NAME = clientname
This option should appear only once in the configuration file.
If more than one entry appears, NetBackup observes only the last CLIENT_NAME entry
listed for the option. The client name in a policy that backs up the client should match
the client name that is specified with CLIENT_NAME.

Note: Do not use an IP address as a client name in a policy or the backup may fail.
Specify a hostname instead.
The bp.conf of the master server does not require the addition of other clients, other
than the master server as CLIENT_NAME = master server name. The name is
added by default.
During a restore, the default is to restore to the client that is named in the policy that
was used for the backup. For an alternate client restore, indicate the name of the
alternate client in the Backup, Archive, and Restore user interface. (Within the user
interface, the Destination client for restores field is located in the Specify NetBackup
Machines and Policy Type dialog box.)
To use the bprestore command, a parameter can be given to bprestore to indicate
the destination client.
See About client-redirected restores on page 1158.
The client installation procedures automatically set CLIENT_NAME to the value that is
specified in ftp_to_client command or install_client command in the
installation scripts.
If the value is not in any bp.conf file, NetBackup uses the value that the
gethostname() library function returns.
See Client Name properties on page 92.
Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on client > Client Name.

COMPRESS_SUFFIX option for NetBackup clients

The COMPRESS_SUFFIX entry specifies a list of file extensions. During a backup,
NetBackup does not compress files with these extensions because the file may
already be in a compressed format.

337

Configuring Host Properties

Configuration options for NetBackup clients

Table 3-134

COMPRESS_SUFFIX information

Usage

Description

Where to use

On NetBackup clients.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
Use the following format:
COMPRESS_SUFFIX = .suffix
By default, COMPRESS_SUFFIX is not present in the bp.conf file. This option has a
reasonable default. Change only if problems result.
Multiple COMPRESS_SUFFIX entries are allowed.
Do not use wildcards to specify these extensions. Do not specify .A* or .A [1-9] (For
example, specify .A1)

Equivalent Administration
Console property

NetBackup Management > Host Properties > Clients Double-click on client > Client
Settings.
See Client Settings properties for UNIX clients on page 108.

CRYPT_CIPHER option for NetBackup clients

The CRYPT_CIPHER entry applies to clients with the NetBackup Encryption option
installed.
Table 3-135

CRYPT_CIPHER information

Usage

Description

Where to use

On NetBackup clients.

338

Configuring Host Properties

Configuration options for NetBackup clients

Table 3-135

CRYPT_CIPHER information (continued)

Usage

Description

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
Use the following format:
CRYPT_CIPHER = value
Where value is one of the following:

AES-128-CFB (used when no method is specified; default)

AES-256-CFB

BF-CFB

DES-EDE-CFB

This option should appear only once in the configuration file.

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on client > Encryption.
See Encryption properties on page 126.
See the NetBackup Security and Encryption Guide.

CRYPT_KIND option for NetBackup clients

The CRYPT_KIND entry on the client determines whether the standard encryption or
legacy encryption is used in the backup. Normally, CRYPT_KIND is set automatically.
The CRYPT_KIND entry applies to clients with the NetBackup Encryption option
installed.
Table 3-136

CRYPT_KIND information

Usage

Description

Where to use

On NetBackup clients.

339

Configuring Host Properties

Configuration options for NetBackup clients

Table 3-136

CRYPT_KIND information (continued)

Usage

Description

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
Use the following format:
CRYPT_KIND = type
The following values can be entered:

NONE

No encryption is used on the client (default)

LEGACY

Legacy pertains to 40-bit and 56-bit data encryption standard (DES). Legacy
encryption is not recommended.
STANDARD
Standard pertains to 128-bit and 256-bit encryption (AES, 3DES, Blowfish cipher).
Standard encryption is recommended.

This option should appear only once in the configuration file.

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on client > Encryption.
See Encryption properties on page 126.
See the NetBackup Security and Encryption Guide.

CRYPT_OPTION option for NetBackup clients

The CRYPT_OPTION entry specifies the encryption options on NetBackup clients.
NetBackup creates this entry automatically in the /usr/openv/netbackup/bp.conf
file on a UNIX client when the bpinst_crypt command is run on the NetBackup
master server.
The CRYPT_OPTION entry applies to clients with the NetBackup Encryption option
installed.
See the NetBackup Security and Encryption Guide.
Do not alter the entry or create this file manually unless it was accidentally deleted.
Table 3-137

CRYPT_OPTION information

Usage

Description

Where to use

On NetBackup clients.

340

Configuring Host Properties

Configuration options for NetBackup clients

Table 3-137

CRYPT_OPTION information (continued)

Usage

Description

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
Use the following format:
CRYPT_OPTION = type
The following values can be entered:

DENIED|denied

Specifies that the client does not permit encrypted backups. If the server requests
an encrypted backup, it is considered an error. This option is the default for a client
that has not been configured for encryption.
ALLOWED|allowed

Specifies that the client allows either encrypted or unencrypted backups.

REQUIRED|required
Specifies that the client requires encrypted backups. If this value is specified and
the server requests an unencrypted backup, it is considered an error.

This option should appear only once in the configuration file.

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on client > Encryption.
See Encryption properties on page 126.

CRYPT_STRENGTH option for NetBackup clients

The CRYPT_STRENGTH entry specifies the encryption strength on NetBackup clients.
It applies to clients with the NetBackup Encryption option installed.
Table 3-138

CRYPT_STRENGTH information

Usage

Description

Where to use

On NetBackup clients.

341

Configuring Host Properties

Configuration options for NetBackup clients

Table 3-138

CRYPT_STRENGTH information (continued)

Usage

Description

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
Use the following format:
CRYPT_STRENGTH = value
The allowable values are as follows:

DES_40|des_40

Specifies 40-bit DES encryption. 40-bit is the default value for a client that has not
been configured for encryption.
DES_56|des_56
Specifies 56-bit DES encryption.

NetBackup creates this entry automatically on a UNIX client when the bpinst_crypt
command is run on the NetBackup master server. This entry should appear only once
in the configuration file.
Do not alter the entry or create it manually unless it was accidentally deleted.
Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on client > Encryption.
See the NetBackup Security and Encryption Guide.
See Encryption properties on page 126.

CRYPT_LIBPATH option for NetBackup clients

The CRYPT_LIBPATH entry specifies the directory that contains the encryption libraries
for NetBackup clients. NetBackup creates this entry automatically in the
/usr/openv/netbackup/bp.conf file on a UNIX client when the bpinst_crypt
command is run on the NetBackup master server.
The CRYPT_LIBPATH entry applies to clients with the NetBackup Encryption option
installed. Do not alter the entry or create it manually unless it was accidentally
deleted. This entry should appear only once in the configuration file.
Table 3-139

CRYPT_LIBPATH information

Usage

Description

Where to use

On NetBackup clients.

342

Configuring Host Properties

Configuration options for NetBackup clients

Table 3-139

CRYPT_LIBPATH information (continued)

Usage

Description

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
Use the following format:
CRYPT_LIBPATH = directory
If necessary, create the entry in the following locations:

The default value on UNIX systems is /usr/openv/lib/

The default value on Windows systems is install_path\bin\

Where install_path is the directory where NetBackup is installed and by default is
C:\Program Files\VERITAS.

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on client > Encryption.
See the NetBackup Security and Encryption Guide.
See Encryption properties on page 126.

CRYPT_KEYFILE option for NetBackup clients

The CRYPT_KEYFILE entry specifies the file that contains the encryption keys on
NetBackup clients. NetBackup creates this entry automatically in the
/usr/openv/netbackup/bp.conf file on a UNIX client when the bpinst_crypt
command is run on the NetBackup master server.
Table 3-140

CRYPT_KEYFILE information

Usage

Description

Where to use

On NetBackup clients.

343

Configuring Host Properties

Configuration options for NetBackup clients

Table 3-140

CRYPT_KEYFILE information (continued)

Usage

Description

How to use

The CRYPT_KEYFILE entry applies to clients with the NetBackup Encryption option
installed. Do not alter the entry or create it manually unless it was accidentally deleted.
Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
Use the following format:
CRYPT_KEYFILE = directory
The default values follow:

On Windows systems
install_path\bin\keyfile.dat
Where install_path is the directory where NetBackup is installed and by default is
C:\Program Files\VERITAS.

On UNIX systems
/usr/openv/netbackup/keyfile

This entry should appear only once in the configuration file.

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on client > Encryption.
See the NetBackup Security and Encryption Guide.
See Encryption properties on page 126.

DISALLOW_SERVER_FILE_WRITES option for NetBackup clients

The DISALLOW_SERVER_FILE_WRITES entry prevents the NetBackup server from
creating files on the NetBackup client. For example, this entry prevents
server-directed restores or server-directed updates of the configuration file on the
client.
Table 3-141

DISALLOW_SERVER_FILE_WRITES information

Usage

Description

Where to use

On NetBackup clients.

344

Configuring Host Properties

Configuration options for NetBackup clients

Table 3-141

DISALLOW_SERVER_FILE_WRITES information (continued)

Usage

Description

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
Use the following format:
DISALLOW_SERVER_FILE_WRITES
By default, server writes are allowed.
This option should appear only once in the configuration file.

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on client > Universal
Settings.
See Universal Settings properties on page 253.

DO_NOT_RESET_FILE_ACCESS_TIME option for NetBackup

clients
The DO_NOT_RESET_FILE_ACCESS_TIME entry specifies that if a file is backed up,
its access time (atime) displays the time of the backup. The default is that
NetBackup preserves the access time by resetting it to the value it had before the
backup.
Note: The DO_NOT_RESET_FILE_ACCESS_TIME entry affects the software and the
administration scripts that examine a files access time. Do not use this option or
USE_CTIME_FOR_INCREMENTALS if Storage Migrator is on the system. Setting these
options causes the atime for files to be updated every time they are backed up.
Each time the atime updates, it appears as if the files are frequently used and
prevents Storage Migrator from selecting the files for migration.
Table 3-142

DO_NOT_RESET_FILE_ACCESS_TIME information

Usage

Description

Where to use

On NetBackup clients.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
Use the following format:
DO_NOT_RESET_FILE_ACCESS_TIME
This option should appear only once in the configuration file.

345

Configuring Host Properties

Configuration options for NetBackup clients

Table 3-142

DO_NOT_RESET_FILE_ACCESS_TIME information (continued)

Usage

Description

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on client > Client Settings.
See Client Settings properties for UNIX clients on page 108.

IGNORE_XATTR option for NetBackup clients

By default, extended attribute files (Solaris 9 or later) and named data streams are
backed up. Use IGNORE_XATTR to exclude extended attributes and named data
streams from backups. (IGNORE_XATTR was formerly IGNORE_XATTR_SOLARIS.)
Table 3-143

IGNORE_XATTR information

Usage

Description

Where to use

On NetBackup clients.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
Use the following format:
IGNORE_XATTR
NetBackup does not check for extended attributes or named data streams if the
IGNORE_XATTR entry is present in the bp.conf file.
This option should appear only once in the configuration file.
See About backing up and restoring extended attribute files and named data streams
on page 807.

Equivalent Administration
Console property

No equivalent exists in the NetBackup Administration Console host properties.

Backing up and restoring the ACL and extended attributes for

GPFS volumes
NetBackup now recognizes the access control list and extended attribute metadata
of General Parallel File System files and folders. By default, NetBackup backs up
and restores the ACL and extended attributes for GPFS volumes. No additional
configuration is necessary.
See the Symantec NetBackup Hardware Compatibility List for supported operating
systems and GPFS versions:
http://www.netbackup.com/compatibility

346

Configuring Host Properties

Configuration options for NetBackup clients

Restoring files with GPFS Extended Attributes to operating systems other than AIX
or RHEL or file systems other than GPFS may generate errors or failed jobs. The
errors occur because the restore target does not recognize the metadata.

Preventing the backup or restore of the ACL and extended

attributes for a GPFS volume

To prevent backups of GPFS extended attributes:

Add the IGNORE_XATTR entry to the bp.conf file on the client:
/usr/openv/netbackup/bp.conf

The entry does not require a value setting; the entry is only IGNORE_XATTR.

To prevent backups of the GPFS ACL:

Add the IGNORE_ACL touch file to the client:
/usr/openv/netbackup/IGNORE_ACL

Note: If extended attributes are allowed to be backed up, the ACL is also backed
up, regardless of whether or not the IGNORE_ACL touch file is present.

To prevent restores of GPFS extended attributes (provided that they were backed
up in the first place):
Add the IGNORE_XATTR touch file to the client:
/usr/openv/netbackup/IGNORE_XATTR

To prevent restores of the GPFS ACL (provided that it was backed up in the
first place):
Add the IGNORE_ACL touch file to the client:
/usr/openv/netbackup/IGNORE_ACL

Note: If extended attributes are allowed for restore, the ACL is also restored,
regardless of whether or not the IGNORE_ACL touch file is present.

Considerations when backing up and restoring GPFS extended

attributes

Upon restore of a file or folder that has an ACL or extended attributes, the ACL
and extended attributes are also restored if they were originally backed up.
However, if the restore job was interrupted, the last file that was in-process may
be skipped when the restore job resumes. In that case, the ACL and the extended
attributes of that file and all subsequent files will not be restored.

347

Configuring Host Properties

Configuration options for NetBackup clients

The IGNORE_XATTR option instructs NetBackup to ignore extended attributes

when backing up files and folders that have extended attributes. In case of a
NetBackup Accelerator initial backup, if IGNORE_XATTR is added to the bp.conf
file or the registry and then is later removed for subsequent backups, perform
a backup with the Accelerator forced rescan option enabled.

If the ACL interface is used to change ACL permissions after a backup is

performed, the restore may not preserve the ACL upon restore.

See Accelerator forced rescan option (schedule attribute) on page 742.

INFORMIX_HOME option for NetBackup clients

The INFORMIX_HOME entry specifies the path to the Informix home directory and is
required when the client uses NetBackup for Informix.
Table 3-144

INFORMIX_HOME information

Usage

Description

Where to use

On NetBackup clients.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
Use the following format:
INFORMIX_HOME
This option should appear only once in the configuration file.

Equivalent Administration
Console property

No equivalent exists in the NetBackup Administration Console host properties.

KEEP_DATABASE_COMM_FILE option for NetBackup clients

The KEEP_DATABASE_COMM_FILE entry causes NetBackup to keep database agent
logs for seven days. The default is that NetBackup keeps database agent logs for
only one day.
Table 3-145

KEEP_DATABASE_COMM_FILE information

Usage

Description

Where to use

On NetBackup clients.

348

Configuring Host Properties

Configuration options for NetBackup clients

Table 3-145

KEEP_DATABASE_COMM_FILE information (continued)

Usage

Description

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
Use the following format:
KEEP_DATABASE_COMM_FILE
For example, add it to a client that runs NetBackup for Informix.
This option should appear only once in the configuration file.

Equivalent Administration
Console property

No equivalent exists in the NetBackup Administration Console host properties.

KEEP_LOGS_DAYS option for NetBackup clients

The KEEP_LOGS_DAYS entry specifies how long to keep job and progress logs of the
NetBackup-Java program, Backup, Archive, and Restore. The default is 3 days.
NetBackup writes these files in the following directories:

/usr/openv/netbackup/logs/user_ops/username/jobs

/usr/openv/netbackup/logs/user_ops/username/logs

A directory exists for each user that uses the Backup, Archive, and Restore
console. This entry also controls how long to keep the log files from the
NetBackup-Java console.
The log files are located in /usr/openv/netbackup/logs/user_ops/nbjlogs.
Table 3-146

KEEP_LOGS_DAYS information

Usage

Description

Where to use

On NetBackup clients.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option in the /usr/openv/netbackup/bp.conf file.
Use the following format:
KEEP_LOGS_DAYS
This option should appear only once in the configuration file.

349

Configuring Host Properties

Configuration options for NetBackup clients

Table 3-146

KEEP_LOGS_DAYS information (continued)

Usage

Description

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on client > Client Settings.
See Client Settings properties for UNIX clients on page 108.
See Client Settings properties for Windows clients on page 113.

LIST_FILES_TIMEOUT option for NetBackup clients

The LIST_FILES_TIMEOUT entry specifies how long to wait for a response from the
server when it lists files by using the client-user interface or bplist. If this time is
exceeded, the user receives a socket read failed error even if the server
continues to process the users request. The default is that LIST_FILES_TIMEOUT
is not in any bp.conf file and NetBackup uses a value of 30 minutes.
Table 3-147

LIST_FILES_TIMEOUT information

Usage

Description

Where to use

On NetBackup clients.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
Use the following format:
LIST_FILES_TIMEOUT
This option should appear only once in the configuration file.
The value in the $HOME/bp.conf file takes precedence if it exists.

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on client > Timeouts.
See Timeouts properties on page 251.

LOCKED_FILE_ACTION option for NetBackup clients

The LOCKED_FILE_ACTION entry specifies the behavior of NetBackup when it backs
up a file that has mandatory file locking enabled in its file mode. (See chmod(1)).
If this entry is set to SKIP, NetBackup skips the files that currently have mandatory
locking set by another process. NetBackup logs a message to this effect.

350

Configuring Host Properties

Configuration options for NetBackup clients

Table 3-148

LOCKED_FILE_ACTION information

Usage

Description

Where to use

On NetBackup clients.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
Use the following format:
LOCKED_FILE_ACTION = SKIP
This option should appear only once in the configuration file.

Note: SKIP is the only legal value for this entry. The default is that NetBackup waits
for files to become unlocked.
Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on client > Client Settings.
See Client Settings properties for UNIX clients on page 108.

MEDIA_SERVER option for NetBackup clients

The MEDIA_SERVER entry specifies that the listed computer is a media server only.
Computers that are listed as media servers can back up and restore clients, but
have limited administrative privileges.
Table 3-149

MEDIA_SERVER information

Usage

Description

Where to use

On NetBackup clients.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
Use the following format:
MEDIA_SERVER = media_server_name
This option should appear only once in the configuration file.

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on client > Servers.
See SERVER option for NetBackup servers on page 314.

MEGABYTES_OF_MEMORY option for NetBackup clients

The MEGABYTES_OF_MEMORY entry specifies how much memory is available on the
client to use to compress files during backup. If compression is selected, the client

351

Configuring Host Properties

Configuration options for NetBackup clients

software uses this value to determine how much space to request for the
compression tables. The more memory that is available to the compress code, the
greater the compression. The percentage of computer resources that are used is
also greater. If other processes also need memory, use a maximum value of one
half the actual physical memory on a computer to avoid excessive swapping.
Table 3-150

MEGABYTES_OF_MEMORY information

Usage

Description

Where to use

On NetBackup clients.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
Use the following format:
MEGABYTES_OF_MEMORY = memory_value
The default is that NetBackup assumes a value of zero megabytes.
This option should appear only once in the configuration file.

Note: The MEGABYTES_OF_MEMORY entry has a reasonable default. Change it only

if problems are encountered.
Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on client > Client Settings.
See Client Settings properties for UNIX clients on page 108.

NFS_ACCESS_TIMEOUT option for NetBackup clients

The NFS_ACCESS_TIMEOUT entry specifies the number of seconds that the backup
process waits to process an NFS mount table. After the time is exceeded, the
process considers an NFS file system to be unavailable.
Table 3-151

NFS_ACCESS_TIMEOUT information

Usage

Description

Where to use

On NetBackup clients.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
Use the following format:
NFS_ACCESS_TIMEOUT = seconds
By default, NFS_ACCESS_TIMEOUT is set to five seconds.
This entry should appear only once in the configuration file.

352

Configuring Host Properties

Configuration options for NetBackup clients

Table 3-151

NFS_ACCESS_TIMEOUT information (continued)

Usage

Description

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on client > UNIX Server.
See UNIX Server properties on page 258.

OLD_VNETD_CALLBACK option for NetBackup clients

The OLD_VNETD_CALLBACK entry specifies that the client should use the client-direct
restore path rather than use the bptm process on a NetBackup media server. The
client-direct restore path bypasses the NetBackup media server for the restore jobs.
Configure this entry on the NetBackup clients that you want to receive data directly
from a Media Server Deduplication Pool storage server.
Before you decommission a media server that hosts a Media Server Deduplication
Pool, you must deactivate MSDP on that media server. See the NetBackup
Deduplication Guide for your release available from the following URL:
http://www.symantec.com/docs/DOC5332
Table 3-152

OLD_VNETD_CALLBACK information

Usage

Description

Where to use

On NetBackup clients.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
Use the following format:
OLD_VNETD_CALLBACK = YES
This entry should appear only once in the configuration file.

Equivalent Administration
Console property

No equivalent exists in the NetBackup Administration Console host properties.

REPORT_CLIENT_DISCOVERIES option for NetBackup clients

By default, the NetBackup Discovery Service (nbdisco) runs on all clients in the
NetBackup environment. The service helps you build Intelligent Policies by reporting
to the master server when it finds instances of applications (such as Oracle).

353

Configuring Host Properties

Configuration options for NetBackup clients

Table 3-153

REPORT_CLIENT_DISCOVERIES information

Usage

Description

Where to use

On NetBackup clients.

How to use

By default, REPORT_CLIENT_DISCOVERIES is not present in the configuration file.

When REPORT_CLIENT_DISCOVERIES is not present, the NetBackup Discovery
Service is enabled.
Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
Use the following format:
REPORT_CLIENT_DISCOVERIES = TRUE | FALSE
This option should appear only once in the configuration file.

Equivalent Administration
Console property

If the entry is set to FALSE, the nbdisco process on that client stops reporting
discoveries to the master server. The service shuts down within 10 minutes after
being set to FALSE and remains down.

To turn on the Discovery Service again, either change the entry on that client to
REPORT_CLIENT_DISCOVERIES = TRUE or remove the entire option. Then, run
bp.start_all on the client to restart the service.

To set this value on a client remotely, run the following command from the master
server:
nbsetconfig -h clientname

No equivalent exists in the NetBackup Administration Console host properties.

RESTORE_RETRIES option for NetBackup clients

The RESTORE_RETRIES entry specifies the number of times to retry a restore after
a failure.
Table 3-154

RESTORE_RETRIES information

Usage

Description

Where to use

On NetBackup clients.

354

Configuring Host Properties

Configuration options for NetBackup clients

Table 3-154

RESTORE_RETRIES information (continued)

Usage

Description

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
Use the following format:
RESTORE_RETRIES = number_of_retries
The default is 0 (no retries).
This option should appear only once in the configuration file.

Note: The RESTORE_RETRIES entry has a reasonable default. Change it only if

problems are encountered.
Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on client > Universal
Settings > Restore retries.
See Universal Settings properties on page 253.

SERVER option for NetBackup clients

The SERVER entry defines the list of NetBackup master servers and media servers
that can access the NetBackup client. During client installation, SERVER is
automatically set to the name of the primary master server for this client.
Other SERVER entries can be added for any other master servers for this client, and
for media servers for this client. Media servers for this NetBackup client can also
be added by using the MEDIA_SERVER option.
Table 3-155

SERVER information

Usage

Description

Where to use

On NetBackup clients.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.

Note: Every SERVER entry in a client bp.conf file must be a NetBackup master or
media server. That is, each system that is listed as a SERVER must have either
NetBackup master or media server software installed. The client service on some
clients cannot be started if the client name is incorrectly listed as a server.
If you configure media servers, each media server must have a SERVER or a
MEDIA_SERVER entry in the bp.conf file of the client.

355

Configuring Host Properties

Configuration options for NetBackup clients

Table 3-155

SERVER information (continued)

Usage

Description

Example

The following is an example bp.conf file on a client:

SERVER = Master_server (default master server)
SERVER = NB_server (other master server)
SERVER = Media_server_#1
MEDIA_SERVER = Media_server_#2
.
.
.
The first SERVER entry denotes the master server to which the client connects to by
default for any requests. (For example, to back up, to list, or to restore files). The
SERVER entry must be present in the /usr/openv/netbackup/bp.conf file on all
UNIX clients. The SERVER entry is the only required entry in the bp.conf file for clients.
The SERVER entry is not used in a $HOME/bp.conf file. On NetBackup UNIX servers,
the SERVER entry applies to both client and the server.
See RESUME_ORIG_DUP_ON_OPT_DUP_FAIL option for NetBackup servers
on page 313.
See MEDIA_SERVER option for NetBackup clients on page 351.

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on client > Servers.
See SERVER option for NetBackup servers on page 314.

SYBASE_HOME option for NetBackup clients

The SYBASE_HOME entry specifies the path to the Sybase home directory. The entry
is required for NetBackup to use Sybase to back up Sybase databases.
Table 3-156

SYBASE_HOME information

Usage

Description

Where to use

On a NetBackup for Sybase client.

356

Configuring Host Properties

Configuration options for NetBackup clients

Table 3-156

SYBASE_HOME information (continued)

Usage

Description

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
Use the following format:
SYBASE_HOME = path_to_Sybase_home_directory
The default is that SYBASE_HOME is not in the configuration file.
This option should appear only once in the configuration file.

Note: This entry is not required to back up the Sybase SQL Anywhere database that
NetBackup uses as part of the NetBackup catalog.
For additional information, see the NetBackup for Sybase Administrator's Guide.
Equivalent Administration
Console property

No equivalent exists in the NetBackup Administration Console host properties.

USE_CTIME_FOR_INCREMENTALS option for NetBackup clients

The USE_CTIME_FOR_INCREMENTALS entry changes how NetBackup determines
whether or not a file has changed. This entry causes the client software to use both
modification time and inode change time during incremental backups to determine
if a file has changed. (mtime and ctime.)
Table 3-157

USE_CTIME_FOR_INCREMENTALS information

Usage

Description

Where to use

On NetBackup clients.

357

Configuring Host Properties

Configuration options for NetBackup clients

Table 3-157

USE_CTIME_FOR_INCREMENTALS information (continued)

Usage

Description

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
Use the following format:
USE_CTIME_FOR_INCREMENTALS
This option should appear only once in the configuration file.
By default, NetBackup uses only mtime.

Note: If you specify USE_CTIME_FOR_INCREMENTALS, you must also specify

DO_NOT_RESET_FILE_ACCESS_TIME. Do not use these options if Storage Migrator
is on the system. Setting these options causes the file atime to be updated every time
they are backed up. When the atime updates, it appears as if the files are frequently
used and prevents Storage Migrator from selecting the files for migration.
See DO_NOT_RESET_FILE_ACCESS_TIME option for NetBackup clients
on page 345.
Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on client > Client Settings
> Reset file access time to the value before backup.

USE_FILE_CHG_LOG option for NetBackup clients

The USE_FILE_CHG_LOG entry specifies whether NetBackup uses the file change
log on VxFS clients. The default is off.
Table 3-158

USE_FILE_CHG_LOG information

Usage

Description

Where to use

On NetBackup clients.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
Use the following format:
USE_FILE_CHG_LOG
This option should appear only once in the configuration file.

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on client > Client Settings
> Use VxFS File Change Log for Incremental Backups.
See VxFS file change log for incremental backups property on page 111.

358

Configuring Host Properties

Configuration options for NetBackup clients

USEMAIL option for NetBackup clients

The USEMAIL entry specifies the email address where NetBackup sends status on
the outcome of operations for a UNIX client.
Table 3-159

USEMAIL information

Usage

Description

Where to use

On NetBackup UNIX clients.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change
the option.
Use the following format:
USEMAIL = [email protected],[email protected],[email protected]

Note: Separate multiple email addresses using a comma, with no spaces.

Add USEMAIL as follows:

If the USEMAIL specifies an address, NetBackup sends automatic backup and

manual backup status to that address.
If the $HOME/bp.conf file specifies an address, NetBackup also sends status on
the success or failure of user operations to that address.

This option should appear only once in the configuration file.

Equivalent Administration
Console property

NetBackup Management > Host Properties > Double-click on client > Universal
Settings.
See Universal Settings properties on page 253.

VXSS_NETWORK option for NetBackup clients

This entry identifies whether a specific network or remote system must or must not
use NetBackup product authentication and authorization with the local system.
It can be configured on NetBackup servers and clients.
See VXSS_NETWORK option for NetBackup servers on page 328.
See Network Attributes tab of the Access Control properties on page 77.

UNIX client examples

The following is an example of a bp.conf file of a UNIX client:
SERVER = server1
CLIENT_NAME = client1
USEMAIL = [email protected]

359

Configuring Host Properties

Configuration options for NetBackup clients

COMPRESS_SUFFIX = .Addrs
COMPRESS_SUFFIX = .Counts
VERBOSE = 1
RESTORE_RETRIES = 1
BPBACKUP_POLICY = U1userdir
BPBACKUP_SCHED = userbackups
BPARCHIVE_POLICY = U1userdir
BPARCHIVE_SCHED = userarchives
LOCKED_FILE_ACTION = SKIP

Nonroot users on UNIX clients can have a personal bp.conf file in their home
directory: $HOME/bp.conf.
Note: A root user cannot have a personal bp.conf file. For root users, NetBackup
uses the /usr/openv/netbackup/bp.conf file.
A personal bp.conf file can have any of the following options:
USEMAIL = [email protected]
BPBACKUP_POLICY = user1
BPBACKUP_SCHED = userback
BPARCHIVE_POLICY = user1
BPARCHIVE_SCHED = userarch
LIST_FILES_TIMEOUT = 10
CLIENT_NAME = alternate_client_name

Specify CLIENT_NAME only when doing restores to an alternate client.

See Configuration options for NetBackup clients on page 330.

360

Chapter

Configuring server groups

This chapter includes the following topics:

About NetBackup server groups

Configuring a NetBackup server group

Deleting a server group

About NetBackup server groups

A server group is a group of NetBackup servers that are used for a common purpose.
The following are the current server group types:
Media Sharing

A Media Sharing group is a server group that shares tape media for
write purposes (backups).
A Media Sharing group can contain the following:

NetBackup master server

NetBackup media servers

NDMP tape servers

Virtual host names of NetBackup media servers in a cluster

Servers can be in more than one group. All members of a Media

Sharing server group must have the same NetBackup master server.
See About media sharing on page 499.
See Configuring media sharing with a server group on page 500.

See Configuring a NetBackup server group on page 362.

Configuring server groups

Configuring a NetBackup server group

Configuring a NetBackup server group

Use the following procedure to configure a server group.
Caution: NetBackup allows a server group name to be the same as the name of a
media server. To avoid confusion, Symantec recommends that you do not use the
same name for a server group and a media server.
See About NetBackup server groups on page 361.

362

Configuring server groups

Configuring a NetBackup server group

To configure a server group

In the NetBackup Administration Console, expand Media and Device

Management > Devices > Server Groups.

In the Actions menu, select New > New Server Groups.

In the New Server Group dialog box, enter or select the appropriate
information.
See NetBackup server group properties on page 363.
To add a server to the group, select it in the Servers Not in Group window
and click Add.
To remove a server from the group, select it in the Servers in Group window
and click Remove.

NetBackup server group properties

The following table describes server group properties that include the following
options.

363

Configuring server groups

Deleting a server group

Table 4-1
Property

Server group properties

Description

Server group name Specifies the name of the server group.

You cannot change the name of an existing server group.
Symantec recommends that server group names be unique. That is, do not use the same name
for a server group that you use for a host such as a media server. If you do, you may not be
able to determine easily if a tape is restricted to a specific media server or to a specific media
server group.
Server group type Specifies the type of server group.
See About NetBackup server groups on page 361.
State

Specifies the state of the server group:

Active. The server group is available for use.

Inactive. The server group is not available for use.

To change the state, select the new state from the dropdown box.
Description

Describes the server group.

Servers in group

Specifies the servers that belong to the group.

Servers not in
group

Specifies the servers that do not belong to the group.

Deleting a server group

Use the following procedure to delete a server group.
To delete a server group

In the NetBackup Administration Console, select Media and Device

Management > Devices > Server Groups.

Select the group to delete.

Select Edit > Delete.

Click OK.

364

Chapter

Configuring host
credentials
This chapter includes the following topics:

About configuring credentials

About configuring credentials

Credentials appears only if a feature that requires external credentials is licensed.
Use Media and Device Management > Credentials to manage log on credentials
for the following:

NetBackup Deduplication Engine credentials.

Create the credentials when you configure the storage server.
See the NetBackup Deduplication Guide.

NDMP hosts.
See the NetBackup for NDMP Administrators Guide.

OpenStorage storage servers.

Configure the credentials when you configure the storage server.
See the NetBackup OpenStorage Solutions Guide for Disk.
See the NetBackup Replication Director Solutions Guide.

Chapter

Managing media servers

This chapter includes the following topics:

Activating or deactivating a media server

Adding a media server

About decommissioning a media server

Previewing references to a media server

Decommissioning a media server

Registering a media server

Deleting all devices from a media server

Removing a device host from the EMM database

Activating or deactivating a media server

When you activate a media server, NetBackup can use it for backup and restore
jobs. You can deactivate a media server. A common reason to do so is to perform
maintenance. When a media server is deactivated, NetBackup does not send job
requests to it.
When you deactivate a media server, the following things occur:

Current jobs are allowed to complete.

If the host is part of a shared drive configuration, it does not scan drives.

Managing media servers

Adding a media server

To activate or deactivate a media server

In the NetBackup Administration Console, expand Media and Device

Management > Media Servers.

From the Media Servers pane, select the media server to activate or deactivate.

On the Actions menu, select Activate or Deactivate.

Adding a media server

The following table describes an overview of how to add a media server to an
existing NetBackup environment.
Note: The NetBackup Enterprise Media Manager service must be active when a
media server is added, devices and volumes are configured, and clients are backed
up or restored.
Table 6-1

Adding a media server

Procedure

Section

On the new media server host, attach the devices and install any software that is See the vendors documentation.
required to drive the storage devices.
On the new media server host, prepare the hosts operating system.

See the NetBackup Device

Configuration Guide.

On the master server, add the new media server to the additional servers list of
See Servers properties
the master server. Also, add the new media server to the additional servers list of on page 229.
the clients that the new media server backs up.
If the new media server is part of a server group, add it to the additional servers
list on all media servers in the group.
To avoid problems with NetBackup, ensure that the host name used in NetBackup
matches the host name in the TCP/IP configuration.
Restart the NetBackup services on the master server and the media servers where See Starting or stopping a
a new server name was added.
service or daemon on page 1036.
Install the NetBackup media server software.

See the NetBackup Installation

Guide.

On the master server, configure the robots and drives that are attached to the
media server.

See Configuring robots and tape

drives by using the wizard
on page 391.

367

Managing media servers

About decommissioning a media server

Table 6-1

Adding a media server (continued)

Procedure

Section

On the master server, configure the volumes.

See About adding volumes

on page 441.

On the master server, add storage units to the media server. Always specify the
media server as the media server for the storage unit.

See Creating a storage unit

on page 537.

The Device Configuration Wizard can create storage units when you configure
robots and drives. Therefore, if you created storage units already, skip this step.
On the master server, configure the NetBackup policies and schedules to use the See About the Policies utility
storage units that are configured on the media server.
on page 653.
Test the configuration by performing a user backup or a manual backup that uses See Performing manual backups
a schedule that specifies a storage unit on the media server.
on page 834.

About decommissioning a media server

You can use the NetBackup nbdecommission to decommission a media server.
The command launches a text-based wizard that guides you through the
decommission process. The wizard removes the references to a media server from
a NetBackup domain. (You may have to remove some references manually; the
wizard provides instructions to do so in most cases.)
Note: If you installed an indexing server on the media server that you want to
decommission, you must first decommission the indexing server.
See the NetBackup Search Administrator's Guide.
The nbdecommission command helps in the following scenarios:

You retire a server that is no longer required. After all of the backup images on
the old server expire, you can use the nbdecommission to remove the old server
from the NetBackup environment.

You replace an old server with a new server and keep the same storage. You
want to access all of the old server storage and backup images from the new
server.

The old server fails, and you need to replace it with a new server.

You tried to decommission a media server manually and references to it still

remain. The wizard may clean up any references that remain.

368

Managing media servers

About decommissioning a media server

Throughout this documentation, the media server to be decommissioned is referred

to as the old server.
Warning: Be careful when you use the nbdecommission command. Because the
command may expire images, data loss may occur. Therefore, you should
understand completely what the command does before you use it. Symantec
recommends that you first preview all of the references to a media server before
you decommission it.
See Previewing references to a media server on page 374.
The following topics provide more information and provide guidance for the entire
process.
See About decommissioning limitations on page 369.
See Before you decommission a media server on page 370.
See Decommission actions on page 371.
See Post decommission recommendations on page 371.
See Previewing references to a media server on page 374.
See Decommissioning a media server on page 375.

About decommissioning limitations

The following are the limitations of the nbdecommission command:

Does not decommission clustered media servers. Those include NetBackup

failover media servers or application clusters.

Does not process the Media Server Deduplication Pools.

Before you decommission a media server that hosts a Media Server
Deduplication Pool, you must deactivate MSDP on that media server. See the
NetBackup Deduplication Guide for your release available from the following
URL:
http://www.symantec.com/docs/DOC5332

Does not update the vm.conf files on the NetBackup servers in your environment.
Therefore, the old server may remain in the vm.conf files on the NetBackup
servers.

Does not update the configuration files on the clients. Therefore, the old server
may remain in the server lists on the clients. If you replace an old server with a
new server, the new server is not added to the server list of the new client.

369

Managing media servers

About decommissioning a media server

Does not process the NetBackup Vault profiles. If NetBackup Vault profiles exist
that refer to the storage units on the old server, update the Vault profiles
manually.

Does not notify you about orphaned resources.

Does not restart the daemons and services on other servers that the
decommissioning affects.

Requires that you shut down all daemons and services on the old server after
it is decommissioned.

Requires that you reconfigure devices on the new server manually (if required).

Requires that you know which jobs are running on the old server. You must kill
them or let them run to completion before you run the decommission process.

The -list_ref option only reports on the references that it removes explicitly.
The command removes some items implicitly and it does not report them. For
example, host aliases and host credentials are removed but not reported.

Requires that you move any media ID generation rules that exist on the old
server. You must move them manually to the media server that performs robot
inventory.

Moves the old server to an Administrative Pause state so that no new jobs are
started. However, NetBackup still can start backup and restore jobs for basic
disk; they obtain resources differently than do jobs for other storage destinations.
Also, the nbdecommission command may clear the Administrative Pause to
expire images (depending on your responses to the wizard). Jobs may start
during this period.

Before you decommission a media server

Before you decommission a media server, Symantec recommends that you do the
following:

Preview the actions of the nbdecommission command.

See Previewing references to a media server on page 374.
Analyze the output of the preview operation to ensure that the command captures
all references to the old server. If it did not, make a list of the items that the
command does not cover and fix them manually later.

Back up the NetBackup catalog before you begin. You can use it to return your
environment to the pre-decommission state if something goes wrong or you
have to abort the decommission.

Run the command during a maintenance window when the load on the
NetBackup environment is minimal.

370

Managing media servers

About decommissioning a media server

Post decommission recommendations

Symantec recommends the following actions after you run the nbdecommission
command:

Follow all of the instructions the command provides.

The command may provide instructions for performing the actions that it cannot
perform. For example, it may provide instructions to cancel the backup jobs that
are active on the old server.

Move the physical storage (if needed) and then reconfigure and reinventory
those devices.

Examine the vm.conf files on all of the NetBackup servers in your environment.
Remove references to the old server and add references to the new server
where necessary.

Remove the old server from the server lists on the clients and add the new
server where necessary.
The nbdecommission command outputs a list of clients that refer to old server.

Verify that the old server was removed correctly. Examine the various logical
components (backup policies, storage units, and so on) to make sure that the
old server references have been removed.

Back up the NetBackup catalog as soon as possible.

Decommission actions
The nbdecommission command deletes the configuration for the old server from
the EMM database, the NetBackup image catalog, and configuration files on servers.
The following table shows the actions it performs for the components that reference
the media server. The table is organized in the order in which the command
processes the component.
Table 6-2
Component

nbdecommission command actions

Action

Storage unit - Tape Deletes the following tape storage units:

Those in which the Storage device attribute specifies a robot for which the old server is the
robot control host.
Those in which the Media server attribute specifies the old server.
Those in which the Media server attribute specifies Any Available and the old server is the
only server that can access the storage unit.

371

Managing media servers

About decommissioning a media server

Table 6-2

nbdecommission command actions (continued)

Component

Action

Tape drive

Deletes the tape drive path for each tape drive that is attached to the old server. If the path on
the old server is the only path, it also deletes the tape drive.
If a path to a drive exists on more than one media server, the tape drive may become unusable.
You may have to connect the tape drive to a different media server and then reconfigure it in
NetBackup. For example, if the old server is a scan host for a shared drive, NetBackup cannot
use the drive if no other host can scan.

Robotic library

Deletes all of the robotic libraries that are attached to the old server.
If the old server is the robot control host for a shared library, the drives and media become
standalone and unusable. You must reconfigure and re-inventory the library.

Tape media

Specifies if you want to expire the following tape media or move them to another media server:

Those assigned to the old server.

Those owned by a media sharing group in which the old server is the only member of the
group.
Those that have no specific Media owner and the last write host is same as the old server.

Storage unit BasicDisk

Storage unit AdvancedDisk

Deletes the storage unit if no images exist on it. If images exist, the wizard lets you choose one
of the following options:

Expire the images and delete the storage unit.

Move the images to the new server. The wizard also updates the Media server field in the
storage unit.
The BasicDisk storage must be shared, and the same disk path must be available on the new
server.

Specifies that if more than one media server can access the disk pool that is the destination of
the storage unit, it does the following:

Removes the old server from the Media Servers list of the storage unit.

Deletes the old server as a storage server.

If the old server is the only server that can access the disk pool, the wizard lets you choose to
do one of the following:

Move the storage and images to the new server and delete the old server as a storage server.
The disk volumes must be available on the new server at the same path as the old server.
Expire the images (if any), delete any storage units that reference the disk pool, delete the
disk pool, and delete the storage server. (A reference is when the disk pool appears in the
Disk pool setting of a storage unit.)

372

Managing media servers

About decommissioning a media server

Table 6-2

nbdecommission command actions (continued)

Component

Action

Storage unit OpenStorage

Specifies that if more than one media server can access the disk pool that is the destination of
the storage unit, it does the following:

Removes the old server from the Media Servers list of the storage unit.

Deletes the media server as an OpenStorage storage server.

If the old server is the only server that can access the disk pool, the wizard lets you choose to
do one of the following:

Transfer the credentials to the new server and update the Media server field in the storage
unit if required.
Expire the images (if any), delete any storage units that reference the disk pool, and delete
the disk pool. (A reference is when the disk pool appears in the Disk pool setting of a storage
unit.)

Storage unit group Specifies that if the nbdecommission command deletes all of the storage units in a storage unit
group, it also deletes the storage unit group. Deleting the storage unit group also may affect
backup policies and storage lifecycle policies.
See Backup policy and schedule and Storage lifecycle policy in this table.
Backup policy and Deactivates any backup policy in which the storage destination (directly or indirectly) is a storage
schedule
unit that the command deletes. Specifically, deactivates any backup policy that meets any of the
following conditions:

Storage lifecycle
policy

Fibre Transport
media server

The destination is a storage unit that the nbdecommission command deleted.

The destination is a storage unit group that contains only one storage unit and the
nbdecommission command deleted that storage unit.

The destination is a storage lifecycle policy and the nbdecommission command deleted the
storage unit that is a Backup operation of the storage lifecycle policy.

Specifies that for each storage lifecycle policy in which one or more operations uses a storage
unit that the command deleted, it does the following:

If images under the SLP control are in-process or yet to be processed, displays the commands
to cancel the SLP jobs and then exits. After you cancel the jobs (or wait until the jobs complete),
rerun the nbdecommission command to continue with the decommissioning.

If all of the images under SLP control are processed, deactivates the storage lifecycle policy.

If a deleted storage unit was used by a Backup or Snapshot operation, deactivates all backup
policies with the storage lifecycle policy as the destination.

Displays the commands necessary to delete the old server as an FT media server and then exits.
After you delete the old server as an FT media server, rerun the nbdecommission command
to continue with the decommissioning.

373

Managing media servers

Previewing references to a media server

Table 6-2

nbdecommission command actions (continued)

Component

Action

bp.conf file

On UNIX NetBackup servers, removes the old server from the following bp.conf file entries:

SERVER

MEDIA_SERVER

CLIENT_NAME

BROWSER

On UNIX master servers, also removes the old server from the FORCE_RESTORE_MEDIA_SERVER
and FAILOVER_RESTORE_MEDIA_SERVERS entries.
Windows registry

On Windows NetBackup servers, removes the old server from the following registry keys:

SERVER

MEDIA_SERVER

CLIENT_NAME

BROWSER

On Windows master servers, also removes the old server from the
FORCE_RESTORE_MEDIA_SERVER and FAILOVER_RESTORE_MEDIA_SERVERS keys.
Clients

Lists the clients on which the old server appears in their server lists. You must remove the
references to the old server manually.

Previewing references to a media server

Use the following procedure to preview the associations and references to a media
server that you want to decommission. Symantec recommends that you preview
the references to a media server before you decommission it.
The old server does not have to be up and responsive.
See About decommissioning a media server on page 368.
See Decommissioning a media server on page 375.

374

Managing media servers

Decommissioning a media server

To preview references to a media server

Run the nbdecommission command on the master server or on a media server.

The following is the command syntax:
On Windows:
install_path\Veritas\NetBackup\bin\admincmd\nbdecommission
-list_ref -oldserver OldServer > file.txt

On UNIX:
/usr/openv/netbackup/bin/admincmd/nbdecommission -list_ref
-oldserver OldServer > file.txt

Replace OldServer with the name of the host to be decommissioned. Replace

file with a name that denotes its contents or purpose.

Analyze the output of the preview operation to ensure that the command
captures all references to the old server. If it did not, make a list of the items
that the command does not cover and fix them manually later.

Decommissioning a media server

This topic is part of a group of topics the provide information about decommissioning
a NetBackup media server.
See About decommissioning a media server on page 368.
Your path through the nbdecommission wizard depends on how you respond to
the wizard prompts. Depending on your environment and how you respond to
prompts, the wizard may advise you to perform an action and then exit. To continue
in the wizard, you must run the wizard again after you perform the advised action.
You may have to exit and rerun the wizard several times.
Note: If you installed an indexing server on the media server that you want to
decommission, you must first decommission the indexing server.
See the NetBackup Search Administrator's Guide.
If active jobs exist on the media server, you must cancel them before the command
can begin to decommission the media server. Alternatively, you can wait until they
finish.
The OldServer does not have to be up and responsive.
Symantec recommends that you preview the media server references before you
decommission a media server.

375

Managing media servers

Decommissioning a media server

See Previewing references to a media server on page 374.

The nbdecommission command logs to the standard NetBackup administrator
commands log directory.
Two procedures exist, as follows:

Replace an old media server with a new media server

See To replace an old media server with a new media server on page 376.

Decommission a media server

See To decommission a media server on page 377.

To replace an old media server with a new media server

Run the nbdecommission command on the master server or on a media server

that is not the object of this operation. The following is the command syntax:
On Windows:
install_path\Veritas\NetBackup\bin\admincmd\nbdecommission
-oldserver OldServer [-newserver NewServer] [-file decom_ops.txt]

On UNIX:
/usr/openv/netbackup/bin/admincmd/nbdecommission -oldserver
OldServer [-newserver NewServer] [-file decom_ops.txt]

Replace OldServer with the name of the host to be decommissioned.

-newserver is optional. If you specify a new server, the new server becomes

the default media server for the replacement operations. If you do not specify
a new server, the wizard prompts you for the new server for each storage type
that contains valid backup images. This method is useful if you want to move
backup images to different media servers. For example, you can move backup
images from tape storage to one media server and backup images from disk
storage to another media server.
-file is optional. It writes the command operations to the specified file. Replace

decom_ops.txt with a name that denotes its purpose or contents. Symantec

recommends that you use the -file option to maintain a record of the command
operations.

Follow the prompts and perform the requested actions.

For example, the command may make changes on the master server and on
multiple media servers. You may be required to restart the NetBackup services
on those servers so that the changes take effect.

376

Managing media servers

Registering a media server

To decommission a media server

Run the following command on the master server or on a media server that is
not the object of this operation. The OldServer does not have to be up and
responsive.
On Windows:
install_path\Veritas\NetBackup\bin\admincmd\nbdecommission
-oldserver OldServer

On UNIX:
/usr/openv/netbackup/bin/admincmd/nbdecommission -oldserver
OldServer

Replace OldServer with the name of the host to be decommissioned.

Follow the prompts and perform the requested actions.

Registering a media server

If the master server is not running when you install a media server, the media server
is not registered. You cannot discover, configure, and manage the devices of that
media server. You must register the media server with the master server.

377

Managing media servers

Deleting all devices from a media server

To register a media server

Start the EMM service on the master server.

On the master server, run the following command. (For hostname, use the host
name of the media server.)
On Windows:
install_path\Veritas\NetBackup\bin\admincmd\nbemmcmd -addhost
-machinename hostname -machinetype media -masterserver server_name
-operatingsystem os_type -netbackupversion
level.major_level.minor_level

On UNIX:
Replace OldServer with the name of the host to be decommissioned.
/usr/openv/netbackup/bin/admincmd/nbemmcmd -addhost -machinename
hostname -machinetype media -masterserver server_name
-operatingsystem os_type -netbackupversion
level.major_level.minor_level

To avoid problems with NetBackup, ensure that the host name that is used in
NetBackup matches the host name in the TCP/IP configuration.
Information about nbemmcmd command usage is available.
See the NetBackup Commands Reference Guide.

Deleting all devices from a media server

You can delete all devices from a media server. The media server can be up, down,
or failed and unrecoverable. All devices include robots, drives, and disk pools.
Two procedures exist: one to delete all robots and drives and the other to delete
disk pools.

378

Managing media servers

Deleting all devices from a media server

To delete all robots and drives from a media server

Enter the following command on the master server:

On Windows:
install_path\NetBackup\bin\admincmd\nbemmcmd -deletealldevices
-machinename server_name -machinetype media

On UNIX:
/usr/openv/netbackup/bin/admincmd/nbemmcmd -deletealldevices
-machinename server_name -machinetype media

Replace server_name with the name of the media server.

To delete disk pools from a media server

If the media server has disk pools configured, remove the media server from
the storage units that use those disk pools. For each storage unit, run the
following command on the master server:
On Windows:
install_path\NetBackup\bin\admincmd\bpsturep -label
storage_unit_label -delhost host_name

On UNIX:
/usr/openv/netbackup/bin/admincmd/bpsturep -label
storage_unit_label -delhost host_name

Replace storage_unit_label with the name of the storage unit and host_name
with the name of the media server.

If the media server is the only storage server for the disk pools, change the
state of the disk pools to DOWN. To do so, enter the following command on
the master server for each disk pool:
On Windows:
install_path\NetBackup\bin\admincmd\nbdevconfig -changestate
-stype server_type -dp disk_pool_name -state DOWN

On UNIX:
/usr/openv/netbackup/bin/admincmd/nbdevconfig -changestate -stype
server_type -dp disk_pool_name -state DOWN

Replace server_type with the type of storage server: AdvancedDisk, PureDisk,

or the vendor string that identifies the OpenStorage server type.
Replace disk_pool_name with the name of the disk pool.

For each disk pool, do the following:

379

Managing media servers

Deleting all devices from a media server

Remove the media server from disk pool access by entering the following
command on the master server:
On Windows:
install_path\NetBackup\bin\admincmd\nbdevconfig -changedp -dp
-disk_pool_name -stype server_type -del_storage_servers
storage_server

On UNIX:
/usr/openv/netbackup/bin/admincmd/nbdevconfig -changedp -dp
disk_pool_name -stype server_type -del_storage_servers
storage_server

Replace disk_pool_name with the name of the disk pool.

Replace server_type with the type of storage server: AdvancedDisk,
PureDisk, or the vendor string that identifies the OpenStorage server type.
Replace storage_server with the name of the media server.

If the disk pool is on disk storage available only to the media server and is
no longer required, delete the disk pool as follows:
On Windows:
install_path\NetBackup\bin\admincmd\nbdevconfig -deletedp -dp
disk_pool_name -stype server_type

On UNIX:
/usr/openv/netbackup/bin/admincmd/nbdevconfig -deletedp -dp
disk_pool_name -stype server_type

You cannot delete a disk pool that has unexpired backup images. You must
first expire the images and delete the image fragments, as follows:

Expire the image as follows:

On Windows:
install_path\NetBackup\bin\admincmd\bpexpdate -dp
disk_pool_name -stype server_type -nodelete

On UNIX:
/usr/openv/netbackup/bin/admincmd/bpexpdate -dp
disk_pool_name -stype server_type -nodelete

Determine the media IDs in the disk pool as follows:

On Windows:
install_path\NetBackup\bin\admincmd\bpimmedia -dp
disk_pool_name -stype server_type -nodelete

On UNIX:
/usr/openv/netbackup/bin/admincmd/bpimmedia -dp
disk_pool_name -stype server_type

Delete each media ID in the disk pool as follows:

380

Managing media servers

Removing a device host from the EMM database

On Windows:
install_path\NetBackup\bin\nbdelete -dt disk_type -media_id
name

On UNIX:
/usr/openv/netbackup/bin/nbdelete -dt disk_type -media_id
name

Removing a device host from the EMM database

Use the following procedure to remove a device host from the Enterprise Media
Manager (EMM) in the NetBackup database.
To remove a device host from the EMM database

In the NetBackup Administration Console, in the left pane, expand Media

and Device Management > Devices > Media Servers.

Select the host.

On the Actions menu, select Enterprise Media Manager Database > Remove
Device Host.

Click Yes in the confirmation dialog box.

381

Section

Configuring storage

Chapter 7. Configuring robots and tape drives

Chapter 8. Configuring tape media

Chapter 9. Inventorying robots

Chapter 10. Configuring disk storage

Chapter 11. Configuring storage units

Chapter 12. Staging backups

Chapter 13. Configuring storage unit groups

Chapter

Configuring robots and tape

drives
This chapter includes the following topics:

About NetBackup robot types

About the device mapping files

Downloading the device mapping files

About configuring robots and tape drives in NetBackup

Configuring robots and tape drives by using the wizard

Updating the device configuration by using the wizard

Adding a robot to NetBackup manually

Managing robots

Adding a tape drive to NetBackup manually

Configuring drive name rules

Adding a tape drive path

Adding a shared tape drive to a NetBackup environment

Correlating tape drives and SCSI addresses on Windows hosts

Correlating tape drives and device files on UNIX hosts

Managing tape drives

Performing device diagnostics

Configuring robots and tape drives

About NetBackup robot types

Verifying the device configuration

About automatic path correction

Enabling automatic path correction

Replacing a device

Updating device firmware

About the NetBackup Device Manager on Windows

About the Media Manager device daemon on UNIX

Stopping and restarting the Device Manager or the device daemon

About NetBackup robot types

A robot is a peripheral device that mounts and unmounts media in tape drives.
NetBackup uses robotic control software to communicate with the robot firmware.
NetBackup classifies robots according to one or more of the following characteristics:

The communication method the robotic control software uses; SCSI and API
are the two main methods.

The physical characteristics of the robot. Library usually refers to a larger robot,
in terms of slot capacity or number of drives. Stacker usually refers to a robot
with one drive and low media capacity (6 - 12 media slots).

The media type commonly used by that class of robots. HCART (1/2-inch
cartridge tape) and 8 mm are examples of media types.

Table 7-1 lists the NetBackup robot types, with drive and slot limits for each type.
To determine which robot type applies to the model of robot that you use, see the
NetBackup Hardware Compatibility List for your NetBackup release. The HCL is
available at www.netbackup.com/compatibility.
Table 7-1

NetBackup robot types

Robot type

Description

Drive limits

Slot limits

Note

ACS

Automated Cartridge System

1680

No limit

API control. The ACS library

software host determines the
drive limit.

TL4

Tape library 4mm

15

SCSI control.

TL8

Tape library 8mm

No limit

16000

SCSI control.

384

Configuring robots and tape drives

About the device mapping files

Table 7-1

NetBackup robot types (continued)

Robot type

Description

Drive limits

Slot limits

Note

TLD

Tape library DLT

No limit

32000

SCSI control.

TLH

Tape library Half-inch

256

No limit

API control.

TLM

Tape library Multimedia

250

No limit

API control.

About the device mapping files

NetBackup uses several files to determine which protocols and settings to use to
communicate with storage devices. NetBackup also uses the files during device
discovery and configuration.
The device mapping files are available for download from the Symantec support
site. The download packages contain the following files:

external_robotics.txt

external_types.txt

Readme.txt

In some cases, you can add support for new or upgraded devices without waiting
for a release update from Symantec. To do so, download the current device mapping
files package from the Symantec support Web site and configure NetBackup to use
that file. For instructions, see the Readme.txt file that is supplied with the device
mapping file package.
Note: The contents of the device mapping files do not indicate support for any of
the devices, only the ability to recognize and automatically configure them.
See Downloading the device mapping files on page 385.
See About configuring robots and tape drives in NetBackup on page 386.

Downloading the device mapping files

Use the following procedure to download the current device mapping files and
update the NetBackup Enterprise Media Manager database with their information.
See About the device mapping files on page 385.

385

Configuring robots and tape drives

About configuring robots and tape drives in NetBackup

To download the current device mapping files

Open the NetBackup landing page on the Symantec support Web site in your
Web browser:
http://entsupport.symantec.com

In the Knowledge Base Search box, enter the following string (include the
quotation marks) and then press Enter:
"device mappings package"

Select the package for your NetBackup release level and operating system.

Download the archive file, either a .tar or .zip depending on operating system.

Follow the instructions in the Readme.txt file to update the device mappings.
The Readme.txt file contains instructions for both Windows and UNIX operating
systems.

About configuring robots and tape drives in

NetBackup
Before you configure robots and tape drives in NetBackup, they must be attached
to the computer and recognized by the operating system. The server platforms that
NetBackup supports may require operating system configuration changes to allow
device discovery.
The NetBackup Device Configuration Guide provides information about how to
configure device drivers for the systems that NetBackup supports.
Configure robots and tape drives in NetBackup as follows:
Device
Configuration
Wizard

Symantec recommends using the Device Configuration Wizard to

add, configure, and update the following types of devices in NetBackup:

Robots, including those attached to NDMP hosts

Tape drives, including those attached to NDMP hosts

Shared drives (for NetBackup Shared Storage Option configurations

only)

See Configuring robots and tape drives by using the wizard

on page 391.
The wizard discovers the devices that are attached to the media servers
and helps to configure them.
See About configuring robots and tape drives in NetBackup
on page 386.

386

Configuring robots and tape drives

About configuring robots and tape drives in NetBackup

Manually

Alternatively, add robots and drives manually as follows:

Use menu options in the NetBackup Administration Console.

See Adding a robot to NetBackup manually on page 392.
See Adding a tape drive to NetBackup manually on page 400.
Use NetBackup commands.
See NetBackup Commands Reference Guide.

Manual methods do not use device discovery.

To add a robot and drives, first add the robot and then add the drives
that are in the robot.

Before configuring robots and drives, read the following topics to understand the
process.
Device configuration examples are available in the NetBackup Device Configuration
Guide.

About device discovery

Device discovery is an exploratory method that determines which peripheral devices
a host can detect. Detection depends on physical attachment (SCSI, Fibre Channel,
and so on) and device state (on and responding or off and not responding). Detection
also depends on host operating system device-layer configuration.
The goal of device discovery is to provide information to enable fully or partially
automatic configuration of peripherals for use with NetBackup. Device discovery
provides data that correlates the devices that are interconnected across multiple
hosts or multiple host bus adapters on the same host.
To discover devices, NetBackup issues SCSI pass-through commands through
operating system device files (on UNIX) or APIs (on Windows). The storage devices
must be attached to the computer and recognized by the operating system. A
pass-through path to a device must exist.
The operating systems that NetBackup supports may require configuration changes
to allow device discovery.
The NetBackup Device Configuration Guide provides information about how to
configure device drivers for the systems that NetBackup supports.
NetBackup can discover the following types of devices:

SCSI-based robotic libraries (such as changers, autoloaders, and stackers)

SCSI-based tape drives

Native parallel SCSI, Fibre Channel Protocol (FCP) and FC-AL (loop) connections

387

Configuring robots and tape drives

About configuring robots and tape drives in NetBackup

SCSI over IP (reported)

API type robots, such as ACS, TLM, and TLH robots

NDMP devices that run NDMP version 3 or later

See Enabling automatic path correction on page 425.

About device serialization

Device serialization is a firmware feature that allows device identification and
configuration. A unique serial number identifies a device.
NetBackup determines device relationships by comparing serial numbers from
multiple sources that refer to the same device. If both a robotic library and a drive
fully support serialization, NetBackup can determine the drive's position (or address)
in the robotic library.
Most robots and drives support device serialization.
If a device supports serialization, the following actions occur when NetBackup
queries the device:

Each robot and each drive return a unique serial number.

Each robot also returns the number of drives and the serial number for each of
the drives in the robot. NetBackup uses the information to determine the correct
drive number for each drive in the robot.

If a device does not support serialization, ask the vendor for a new firmware revision
that returns serial numbers. Even with the proper firmware, some devices require
the vendor to perform other actions to enable serialization for the device.
If you know that the devices do not support serialization, make sure that you follow
the maximum configuration limits that the devices allow. You also must coordinate
the drives to their device files or SCSI addresses so you can configure them
correctly.
See Correlating tape drives and SCSI addresses on Windows hosts on page 409.
See Correlating tape drives and device files on UNIX hosts on page 411.
The more devices in the configuration that do not support serialization, the greater
the chance of configuration problems by using the Device Configuration Wizard.

About adding devices without discovery

NetBackup supports some devices that cannot be discovered automatically.
NetBackup also supports some devices that require user intervention during the
discovery process. To add and configure those devices, select NetBackup

388

Configuring robots and tape drives

About configuring robots and tape drives in NetBackup

Administration Console > Media and Device Management or use the tpconfig
command.
For the devices that NetBackup cannot discover or that do not have serial numbers,
automatic device path correction is limited.

About robot control

When you add a robot to NetBackup manually, you must configure how the robot
is controlled. The New Robot dialog box includes a section named Robot control,
in which you configure the control options.
See Robot control (robot configuration options) on page 395.
The following table lists the information that is required to configure the three robot
control types (local, NDMP, and remote). The information that is required depends
on the robot type and the media server type.
Table 7-2

Robot control information

Robot
type

Media server type

Robot
control

ACS

Windows, AIX, Solaris SPARC, HP-UX (except NDMP

HP IA64), and Linux (except Linux64)

NDMP host name and robot device

ACS

All

Remote

ACSLS host

TL4

UNIX

Local

Robotic device file

TL4

Windows

Local

Robot device or SCSI coordinates

TL8

UNIX

Local

Robotic device file

TL8

Windows

Local

Robot device or SCSI coordinates

TL8

Windows, AIX, Solaris SPARC, HP-UX (except NDMP

HP IA64), and Linux (except Linux64)

NDMP host name and robot device

TL8

All

Remote

Robot control host

TLD

UNIX

Local

Robotic device file

TLD

Windows

Local

Robot device or SCSI coordinates

TLD

Windows, AIX, Solaris SPARC, HP-UX (except NDMP

HP IA64), and Linux (except Linux64)

NDMP host name and robot device

TLD

All

Robot control host

Remote

Information required for configuration

389

Configuring robots and tape drives

About configuring robots and tape drives in NetBackup

Robot control information (continued)

Table 7-2
Robot
type

Media server type

Robot
control

Information required for configuration

TLH

All (except Solaris Opteron, HP IA64, AIX,

Linux, and Linux64)

Local

Library name

TLH

AIX

Local

LMCP device file

TLH

Windows, AIX, Solaris SPARC, HP-UX (except NDMP

HP IA64), and Linux (except Linux64)

NDMP host name and robot device

TLH

All (except Solaris Opteron, Linux64)

Remote

Robot control host

TLM

All (except Linux64 and HP IA64)

Remote

DAS/SDLC server

Library sharing example

Figure 7-1 shows library sharing with two servers using two drives in a TLD robot.
The robotic control for the robot is on the host that is named eel. One drive in the
robot is connected to eel and the other is connected to the host shark.
Host eel is the robot control host. To configure this robot on host eel, select Robot
is controlled locally by this device host. To configure this robot on host shark,
select Robot control is handled by a remote host. Then, enter eel for the Robot
control host.
Robot control host example

Figure 7-1
eel

TLD Robotic
Control

shark

Drive 1

Drive 2

TLD robot (HP EML E-Series)

About drive name rules

The drive name rules define the rules NetBackup uses to name drives.
The default, global drive name rule creates names in the following format:
vendor ID.product ID.index

390

Configuring robots and tape drives

Configuring r