Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
Release 6.5
12308278
Veritas
NetBackup Administrator’s Guide, Volume II
Copyright © 1993-2007 Symantec Corporation. All rights reserved.
NetBackup 6.5
Symantec, the Symantec logo, and NetBackup 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.
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.
Symantec Corporation
20330 Stevens Creek Blvd.
Cupertino, CA 95014
www.symantec.com
Technical support
For technical assistance, visit http://entsupport.symantec.com and select phone
or email support. Use the Knowledge Base search feature to access resources
such as TechNotes, product alerts, software downloads, hardware compatibility
lists, and our customer email notification service.
Contents
Demultiplexing .............................................................................................23
ALLOW_MEDIA_OVERWRITE ...........................................................32
ALLOW_MULTIPLE_RETENTIONS_PER_MEDIA ..........................33
ALLOW_NON_RESERVED_PORTS ....................................................33
AUTHENTICATION_DOMAIN ...........................................................33
AUTHORIZATION_SERVICE ..............................................................34
BPBRM_VERBOSE ................................................................................35
BPDBJOBS_COLDEFS ...........................................................................36
BPDBM_VERBOSE ................................................................................38
BPRD_VERBOSE ...................................................................................39
BPTM_VERBOSE ..................................................................................39
BPEND_TIMEOUT ................................................................................40
BPSTART_TIMEOUT ...........................................................................41
CHECK_RESTORE_CLIENT ................................................................41
CLIENT_CONNECT_TIMEOUT ..........................................................41
CLIENT_PORT_WINDOW ...................................................................41
CLIENT_READ_TIMEOUT ..................................................................42
CLIENT_RESERVED_PORT_WINDOW .............................................43
CONNECT_OPTIONS ...........................................................................43
DEFAULT_CONNECT_OPTIONS ......................................................45
DISABLE_JOB_LOGGING .................................................................... 46
DISABLE_STANDALONE_DRIVE_EXTENSIONS ............................ 46
DISALLOW_BACKUPS_SPANNING_MEDIA ................................... 46
DISALLOW_CLIENT_LIST_RESTORE .............................................. 47
DISALLOW_CLIENT_RESTORE ......................................................... 47
EMMSERVER ........................................................................................ 47
ENABLE_ROBUST_LOGGING ............................................................ 48
FAILOVER_RESTORE_MEDIA_SERVERS ........................................ 48
FORCE_RESTORE_MEDIA_SERVER ................................................. 49
GENERATE_ENGLISH_LOGS ............................................................. 49
INCOMPLETE_JOB_CLEAN_INTERVAL ........................................... 50
INITIAL_BROWSE_SEARCH_LIMIT ................................................. 50
LIMIT_BANDWIDTH ........................................................................... 50
MEDIA_ID_PREFIX .............................................................................. 53
MEDIA_UNMOUNT_DELAY .............................................................. 54
MEDIA_REQUEST_DELAY ................................................................. 54
MEDIA_SERVER ................................................................................... 54
MPX_RESTORE_DELAY ...................................................................... 54
MUST_USE_LOCAL_DRIVE ............................................................... 55
NBRB_CLEANUP_OBSOLETE_DBINFO ............................................ 55
NBRB_ENABLE_OPTIMIZATIONS .................................................... 55
NBRB_FORCE_FULL_EVAL ................................................................ 55
NBRB_REEVAL_PENDING ................................................................. 56
NBRB_REEVAL_PERIOD ..................................................................... 56
NBRB_RETRY_DELAY_AFTER_EMM_ERR ..................................... 56
NBRB_MPX_GROUP_UNLOAD_DELAY ........................................... 56
RANDOM_PORTS ................................................................................ 57
RE_READ_INTERVAL ......................................................................... 57
REQUIRED_INTERFACE ..................................................................... 57
REQUIRED_NETWORK ....................................................................... 59
SERVER ................................................................................................. 59
SERVER_PORT_WINDOW ................................................................. 61
SERVER_RESERVED_PORT_WINDOW ........................................... 61
SKIP_RESTORE_TO_SYMLINK_DIR ................................................. 62
SERVER_CONNECT_TIMEOUT ......................................................... 62
UNLINK_ON_OVERWRITE ................................................................ 63
USE_VXSS ............................................................................................. 64
VERBOSE ............................................................................................... 64
VXSS_NETWORK ................................................................................. 64
ALLOW_NON_RESERVED_PORTS ................................................... 67
AUTHENTICATION_DOMAIN ........................................................... 67
BPARCHIVE_POLICY ........................................................................... 68
BPARCHIVE_SCHED ............................................................................68
BPBACKUP_POLICY .............................................................................68
BPBACKUP_SCHED .............................................................................69
BUSY_FILE_ACTION ...........................................................................69
BUSY_FILE_DIRECTORY ....................................................................69
BUSY_FILE_NOTIFY_USER ................................................................70
BUSY_FILE_PROCESSING ..................................................................70
CLIENT_NAME .....................................................................................70
CLIENT_PORT_WINDOW ...................................................................71
CLIENT_READ_TIMEOUT ..................................................................71
CLIENT_RESERVED_PORT_WINDOW .............................................71
COMPRESS_SUFFIX ............................................................................71
CRYPT_CIPHER ....................................................................................72
CRYPT_KIND ........................................................................................72
CRYPT_OPTION ...................................................................................73
CRYPT_STRENGTH .............................................................................73
CRYPT_LIBPATH .................................................................................74
CRYPT_KEYFILE ..................................................................................74
DISALLOW_SERVER_FILE_WRITES ................................................75
DO_NOT_RESET_FILE_ACCESS_TIME ............................................75
GENERATE_ENGLISH_LOGS .............................................................75
IGNORE_XATTR ...................................................................................76
INFORMIX_HOME ................................................................................76
INITIAL_BROWSE_SEARCH_LIMIT .................................................76
KEEP_DATABASE_COMM_FILE ........................................................76
KEEP_LOGS_DAYS ..............................................................................76
LIST_FILES_TIMEOUT ........................................................................77
LOCKED_FILE_ACTION ......................................................................77
MEDIA_SERVER ...................................................................................77
MEGABYTES_OF_MEMORY ...............................................................78
NFS_ACCESS_TIMEOUT .....................................................................78
RANDOM_PORTS .................................................................................78
RESTORE_RETRIES .............................................................................78
REQUIRED_INTERFACE .....................................................................79
SERVER_PORT_WINDOW ..................................................................79
SERVER ..................................................................................................79
SYBASE_HOME ....................................................................................80
USE_CTIME_FOR_INCREMENTALS .................................................80
USE_FILE_CHG_LOG ...........................................................................80
USE_VXSS .............................................................................................80
USEMAIL ...............................................................................................81
VERBOSE ...............................................................................................81
VXSS_NETWORK .................................................................................81
ACS_mediatype ......................................................................................83
ACS_SEL_SOCKET ............................................................................... 83
ACS_CSI_HOSTPORT .......................................................................... 83
ACS_SSI_HOSTNAME ......................................................................... 84
ACS_SSI_INET_PORT .......................................................................... 84
ACS_SSI_SOCKET ................................................................................ 85
ADJ_LSM ............................................................................................... 85
API_BARCODE_RULES ....................................................................... 87
AUTHORIZATION_REQUIRED .......................................................... 87
AUTO_PATH_CORRECTION .............................................................. 88
AUTO_UPDATE_ROBOT .................................................................... 88
AVRD_PEND_DELAY .......................................................................... 88
AVRD_SCAN_DELAY .......................................................................... 89
CLEAN_REQUEST_TIMEOUT ............................................................ 89
CLIENT_PORT_WINDOW ................................................................... 89
CLUSTER_NAME ................................................................................. 90
CONNECT_OPTIONS ........................................................................... 90
DAS_CLIENT ......................................................................................... 91
DAYS_TO_KEEP_LOGS ....................................................................... 91
EMM_RETRY_COUNT ......................................................................... 92
EMM_CONNECT_TIMOUT ................................................................. 92
EMM_REQUEST_TIMOUT ................................................................. 92
ENABLE_ROBOT_AUTH ..................................................................... 92
INVENTORY_FILTER .......................................................................... 93
MAP_ID .................................................................................................. 93
MAP_CONTINUE_TIMEOUT ............................................................. 94
MEDIA_ID_BARCODE_CHARS .......................................................... 94
MEDIA_ID_PREFIX .............................................................................. 95
MM_SERVER_NAME ........................................................................... 95
PREFERRED_GROUP .......................................................................... 96
PREVENT_MEDIA_REMOVAL ........................................................... 96
RANDOM_PORTS ................................................................................ 96
REQUIRED_INTERFACE ..................................................................... 97
SERVER ................................................................................................. 97
SSO_DA_REREGISTER_INTERVAL .................................................. 98
SSO_DA_RETRY_TIMEOUT ............................................................... 98
SSO_HOST_NAME ............................................................................... 98
TLH_mediatype .................................................................................... 98
TLM_mediatype ....................................................................................99
VERBOSE ...............................................................................................99
BUSY_FILE_PROCESSING ................................................................106
BUSY_FILE_DIRECTORY ..................................................................107
BUSY_FILE_ACTION .........................................................................107
Defining and managing storage units and storage unit groups .........119
10
11
Compression ...............................................................................................167
Examples .....................................................................................................168
backup_notify .....................................................................................173
backup_exit_notify ............................................................................173
dbbackup_notify .................................................................................183
diskfull_notify ....................................................................................184
mail_dr_info.sh ...................................................................................184
parent_end_notify .............................................................................185
parent_start_notify ............................................................................185
restore_notify .....................................................................................186
session_notify .....................................................................................186
session_start_notify ..........................................................................187
12
13
14
Troubleshooting .................................................................................................246
To modify diskette sets for use with multiple Windows 2000 computers
15
255
Index 271
16
Chapter 1
Additional configuration
This chapter explains settings that, in most instances, are optional. The sections
in this chapter include the following:
■ “Multiplexing” on page 17
Multiplexing
NetBackup multiplexing sends concurrent backups from one or several clients
to a single storage device. NetBackup multiplexes the backups sequentially onto
the media. Multiplexed and unmultiplexed backups can reside on the same
volume. Separate volume pools or media IDs are not necessary.
18 Additional configuration
Multiplexing
Clients
Disk Server
Removable media or
magnetic disk
Disk
Disk
Note: To reduce the impact of multiplexing on restore times, set the storage unit
maximum fragment size to a value smaller than the largest allowed value. Also,
enable fast-tape positioning (locate block), if it applies to the tape drives in use.
■ Storage unit
■ Schedule
Note: If you change these values, it does not take effect until the next time a
schedule runs.
backups NetBackup can multiplex onto any single drive in the storage unit. The
For more information, see “Enable multiplexing” on page 230 in the NetBackup
The number can range from 1 through 32, where 1 is the default and specifies no
multiplexing.
Choose a value that is based on the ability of the central processing unit to
handle parallel jobs. Because extra buffers are required, memory is also
important. If the server cannot perform other tasks or runs out of memory or
processes, reduce the Maximum Streams Per Drive setting for the storage unit.
Consider the following to estimate the potential load that multiplexing can place
■ The maximum concurrent jobs that NetBackup can attempt equals the sum
of the concurrent backup jobs that can run on all storage units.
■ The maximum concurrent jobs that can run on a storage unit equals the
Maximum Streams Per Drive value, multiplied by the number of drives.
For more information, see “Media multiplexing” on page 141 in the NetBackup
The Media Multiplexing value specifies the maximum number of backups from
The Media Multiplexing setting ranges from 1 through 32, where 1 is the default
maximum jobs that NetBackup starts never exceeds the Maximum Streams Per
Drive value for the storage unit. NetBackup attempts to add multiplexed jobs to
drives that are already use multiplexing. If multiplexed jobs are confined to
20 Additional configuration
Multiplexing
When NetBackup multiplexes jobs, it continues to add jobs to a drive until the
number of jobs on the drive matches either of the following:
■ This schedule’s Media Multiplexing setting.
If the limit is reached for a drive, NetBackup sends jobs to other drives. In
the following figure, when the Schedule A limit is reached on Drive 1,
NetBackup adds Schedule A jobs to Drive 2.
■ The storage unit’s Maximum streams per drive setting. NetBackup can add
jobs from more than one schedule to a drive.
In the following figure, unshaded numbers denote a job starting. Shaded
numbers denote job completion. For example, 1 denotes the start of job
A1 on Drive 1.
9 denotes the completion of job A1 on Drive 1.
Additional configuration 21
Multiplexing
1 9 A1 B1 5 12
2 10 A2 Drive 1
B2 6
A5
13
cat otter
3 11 A3 B3 7
Drive 2
4 A4 B4 8
Assume schedule A begins first (note that the schedules can be in the same or in different
policies). Also, assume that Allow Multiple Data Streams is enabled, so a client can have multiple
data streams.
Jobs A1 and A2 from client dog start on drive 1. Schedule A Media Multiplexing limit of 2
1 2 is reached for this drive.
3 4 Jobs A3 and A4 from client cat start on drive 2. Schedule A Media Multiplexing limit of 2 is
reached for this drive.
5 6 Jobs B1 and B2 for client fox start on drive 1. Storage unit max mpx is reached for this
drive.
Jobs B3 and B4 from client otter start on drive 2. All jobs are now running for schedule B.
7 8 Storage Unit Max mpx is reached for drive 2.
Jobs A1 and A2 from client dog finish on drive 1. However, jobs B1 and B2 for client fox
9 10 continue to run. Schedule A Media Multiplexing limit of 2 prevents job A5 from starting on
drive 1.
11 12 Job A3 from client cat finishes on drive 2 and job B1 from client fox finishes on drive 1.
Job B2 is the only job currently running on drive 1.
Job A5 from client cat starts on drive 1. JobA5 is the last job for schedule A. Schedule A
13 Media Multiplexing limit of 2 prevents job A5 from starting on Drive 2. Therefore, job A5
starts on Drive 1. NetBackup attempts to add multiplexed jobs to drives that already use
multiplexing. If multiplexed jobs are confined to specific drives, other drives are available
for non-multiplexed jobs.
22 Additional configuration
Multiplexing
Note: If the backup window closes before NetBackup can start all the jobs in a
multiplexing set, NetBackup completes only the jobs that have started. For
example, Figure 1-1 on page 21 assumes that the Activity Monitor shows A1
through A5 as queued and active. If only A1 and A2 start before the window
closes, NetBackup does not perform the other jobs that are in the set. If the
window closes before any jobs have started, then only the first queued and
active job starts and completes. (A1 in this example.)
multiplexing.
For more information, see “Limit jobs per policy” on page 97 in the NetBackup
For more information, see “Maximum data streams” on page 387 in the
Demultiplexing
Demultiplexing speeds up future restores and is useful for creating a copy for
off-site storage. Use duplication to demultiplex a backup.
Duplication allows one multiplexed backup at one time to be copied from the
source media to the target media. When duplication is complete, the target
contains a single demultiplexed copy of each duplicated backup. (The target can
also contain other backups.) The duplicate copy can be made into the primary
copy. Do not select Preserve Multiplexing in the Setup Duplication Variables
dialog box when backups are duplicated.
For a large site, you can use multiple NetBackup master servers to optimize the
backup loads. You divide the clients between the servers as necessary. The
following figure shows a multiple-server configuration where the two sets of
networks (A1/A2 and B1/B2) each have enough clients to justify separate
servers. In this environment, the two NetBackup server configurations are
completely independent. You can also create a configuration where one server is
the master and the other is a media server.
Workstations
Network A1
NetBackup Workstations
Mass Master Server A
Storage
Network A2
NetBackup
Mass
Master Server B
Storage
Network B1
Workstations
Router
Workstations
Network B2
Additional configuration 25
Using multiple media servers with one master server
The following figure shows where software is installed and where the
NetBackup catalogs are located (by default). The following topics provide more
details on master and media servers and a procedure to configure them.
Master Server
Administration
Interface*
NetBackup Catalogs User Interface (BAR)
Image database
Information in
NetBackup Storage Administration
relational databases
Client Device Interface*
(about devices,
volumes)
NetBackup NetBackup
Storage Storage
Device Media Server Media Server Device
* You can also use the Backup, Archive, and Restore user
interface from a Windows client that has the Remote
Administration Console installed.
NetBackup catalogs
Applies to NetBackup Enterprise Server only.
The master server is the default location for the NetBackup catalogs. The
catalogs include the media and the volume database (emm_data.db). The volume
database contains the media usage information and the volume information
that are used during the backups.
Note: The NetBackup Enterprise Media Manager service must be active when
you add a media server, configure devices and volumes, and backup or restore
clients.
Note: To avoid problems with NetBackup, ensure that the host name you
use in NetBackup matches the host name in your TCP/IP configuration.
To add the new media server to the additional servers list, do the following:
a Select NetBackup Management > Host Properties > hosttype. For
example, to add the new media server to clients, select Clients.
28 Additional configuration
Adding a media server
b Select the host that you want to change in the right pane. To select more
than one host, hold down the Shift key and select all the hosts that you
want to change in the right pane.
c Select Actions > Properties.
g Click Close.
h Click OK.
a Add storage units to the media server. Always specify the media server
as the media server for the storage unit.
b Enter the catalog paths if necessary:
To use the online, hot catalog backup method:
NetBackup enters the paths automatically.
To use the offline, cold catalog backup method:
Add the catalog paths for the media server to the NetBackup catalog
backup configuration.
media_server_name:install_path\NetBackup\db
media_server_name:install_path\NetBackup\var
media_server_name:install_path\Volmgr\database
Where install_path is the directory where the NetBackup
software is installed on the media server.
Paths on a UNIX media server:
media_server_name:/usr/openv/netbackup/db
media_server_name:/usr/openv/var
media_server_name:/usr/openv/volmgr/database
c Configure the NetBackup policies and schedules to use the storage units
that are configured on the media server.
10 Test your configuration by performing a user backup or a manual backup
that uses a schedule that specifies a storage unit on the media server.
is not registered. You cannot discover, configure, and manage devices. You must
2 On the EMM server host, run the following command (use the host name of
the media server):
nbemmcmd -addhost -machinename hostname -machinetype media
-netbackupversion level.major_level.minor_level
30 Additional configuration
Adding a media server
Note: To avoid problems with NetBackup, ensure that the host name you
use in NetBackup matches the host name in your TCP/IP configuration.
For nbemmcmd command usage, see NetBackup Commands for UNIX and Linux
or NetBackup Commands for Windows.
Additional configuration 31
NetBackup configuration options
Note: Stop and restart all NetBackup daemons and utilities after making a
change to the /usr/openv/netbackup/bp.conf file on the master
server. Restart the daemons to ensure that the new bp.conf values are
used all the NetBackup processes that require them. 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.
For information about client options, see “bp.conf options for UNIX clients” on
page 66.
ALLOW_MEDIA_OVERWRITE
The ALLOW_MEDIA_OVERWRITE option overrides NetBackup’s overwrite
UNIX master server. Or, set the Allow media overwrite property in the Media
host properties.
Volume I.
For example, to permit overwriting the cpio format, add the following on the
ALLOW_MEDIA_OVERWRITE = CPIO
Additional configuration 33
NetBackup configuration options
ALLOW_MULTIPLE_RETENTIONS_PER_MEDIA
The ALLOW_MULTIPLE_RETENTIONS_PER_MEDIA entry allows NetBackup to
mix retention levels on media. Default: This option is not present and each
volume can contain backups of one retention level.
This option can be set using either of the following methods:
■ Changing the Enable standalone drive extension property in the Media host
properties. (Default: enabled.)
For more information, see Chapter 7 of the NetBackup Administrator’s
Guide, Volume I.
■ By using the nbemmcmd command. (See NetBackup Commands for UNIX and
Linux.)
ALLOW_NON_RESERVED_PORTS
The ALLOW_NON_RESERVED_PORTS entry specifies that the NetBackup Client
daemon (bpcd) can accept remote connections from nonprivileged ports (port
numbers 1024 or greater). If this entry is not present, then bpcd requires
remote connections to come from privileged ports (port numbers 1024 or
smaller). This option can be useful when NetBackup clients and servers are on
opposite sides of a firewall.
ALLOW_NON_RESERVED_PORTS = YES | NO
AUTHENTICATION_DOMAIN
The AUTHENTICATION_DOMAIN entry defines a set of Symantec product
If a media server or client does not define an authentication domain, it uses the
UNIX master server. Or, add a domain in the Authentication Domain tab of the
Volume I.
port ]
34 Additional configuration
NetBackup configuration options
Where:
■ 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 following keywords
indicate the mechanism:
■ NIS (Network Information Service version 1)
■ NIS+ (Network Information Service version 2)
■ PASSWD (Local UNIX password file on the specified broker)
■ VXPD (the Symantec 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.
Example
AUTHENTICATION_DOMAIN = mycompany.com "Typical UNIX logins" NIS
broker1.mycompany.com
broker1.mycompany.com
The broker on host name broker1 handles both NIS and private authentication
The broker on host name broker3 uses its local /etc/passwd file for
AUTHORIZATION_SERVICE
The AUTHORIZATION_SERVICE entry defines the Symantec product
authorization service that the local NetBackup server uses. A master server that
uses Symantec product authorization must define an authorization service. If a
Additional configuration 35
NetBackup configuration options
media server does not define an authorization service, it uses its master server's
authorization service.
UNIX master server. Or, enter a host name in the Authorization Service tab in
Volume I.
Where:
port is the port number of the authorization service. The default is the
BPBRM_VERBOSE
Used for debugging purposes, the BPBRM_VERBOSE option controls the amount
of information NetBackup includes in its bpbrm debug log. Default: The same
value as the bp.conf VERBOSE entry (Global logging level). The
BPBRM_VERBOSE entry overrides the bp.conf VERBOSE entry.
Use this option by adding it to the /usr/openv/netbackup/bp.conf file on a
UNIX master server. Or, set the BPBRM logging level property in the Logging
host properties.
For more information, see Chapter 7 of the NetBackup Administrator’s Guide,
Volume I.
To use the same value as the bp.conf VERBOSE entry for bpbrm, enter:
BPBRM_VERBOSE = 0
The entry is the same as setting BPBRM logging level in the Logging host
properties to Same as Global.
To log the minimum amount of information for bpbrm, enter:
BPBRM_VERBOSE = -1
The entry is the same as setting BPBRM logging level in the Logging host
properties to 0.
To log additional information for bpbrm, enter a value of 1 through 5:
BPBRM_VERBOSE = 1
The entry is the same as setting BPBRM logging level in the Logging host
properties to 1.
To log the maximum amount of information for bpbrm, enter:
BPBRM_VERBOSE = 5
The entry is the same as setting BPBRM logging level in the Logging host
properties to 5.
36 Additional configuration
NetBackup configuration options
For more information about the bpbrm debug log, see the NetBackup
Troubleshooting Guide for UNIX and Windows.
BPDBJOBS_COLDEFS
Add BPDBJOBS_COLDEFS entries to the bp.conf file to customize the output of
bpdbjobs. Add a BPDBJOBS_COLDEFS entry for every column you want to
include in the output using the following format:
BPDBJOBS_COLDEFS = COLDEFS_ENTRY [minimum_size [true |
false]]
Where:
COLDEFS_ENTRY is the name of the column to include in the output. See the
following table for valid BPDBJOBS_COLDEFS entries.
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 that the column headings appear.
Example
BPDBJOBS_COLDEFS = JOBID 5 true
OWNER Owner
BPDBM_VERBOSE
Used for debugging purposes, the BPDBM_VERBOSE option controls the amount
UNIX master server. Or, set the BPDBM logging level property in the Logging
host properties.
Volume I.
Default: The same value as the bp.conf VERBOSE entry (Global logging level).
logging level).
To use the same value as the bp.conf VERBOSE entry for bpdbm, enter:
BPDBM_VERBOSE = 0
The entry is the same as setting BPDBM logging level in the Logging host
properties to Same as Global.
To log the minimum amount of information for bpdbm, enter:
BPDBM_VERBOSE = -1
The entry is the same as setting BPDBM logging level in the Logging host
properties to 0.
To log additional information for bpdbm, enter a value of 1 through 5:
BPDBM_VERBOSE = 1
The entry is the same as setting BPDBM logging level in the Logging host
properties to 1.
To log the maximum amount of information for bpdbm, enter:
BPDBM_VERBOSE = 5
The entry is the same as setting BPDBM logging level in the Logging host
properties to 5.
The following examples show two bp.conf entries that enable logging, while
Additional configuration 39
NetBackup configuration options
VERBOSE = 5
BPDBM_VERBOSE = -1
For more information about the bpdbm debug log, see the NetBackup
Troubleshooting Guide for UNIX and Windows.
BPRD_VERBOSE
Used for debugging purposes, the BPRD_VERBOSE option controls the amount of
information NetBackup includes in its bprd debug logs.
UNIX master server. Or, set the BPRD logging level property in the Logging host
properties.
Default: The same value as the bp.conf VERBOSE entry (Global logging level).
logging level).
To use the same value as the bp.conf VERBOSE entry for bprd, enter:
BPRD_VERBOSE = 0
The entry is the same as setting BPRD logging level in the Logging host
properties to Same as Global.
To log the minimum amount of information for bprd, enter:
BPRD_VERBOSE = -1
The entry is the same as setting BPRD logging level in the Logging host
properties to 0.
To log additional information for bprd, enter a value of 1 through 5:
BPRD_VERBOSE = 1
The entry is the same as setting BPRD logging level in the Logging host
properties to 1.
To log the maximum amount of information for bprd, enter:
BPRD_VERBOSE = 5
The entry is the same as setting BPRD logging level in the Logging host
properties to 5.
For more information about the bprd debug log, see the NetBackup
BPTM_VERBOSE
Used for debugging purposes, the BPTM_VERBOSE option controls the amount of
information NetBackup includes in its bptm debug logs.
40 Additional configuration
NetBackup configuration options
UNIX master server. Or, set the BPTM logging level property in the Logging host
properties.
Volume I.
Default: The same value as the bp.conf VERBOSE entry (Global logging level).
logging level).
To use the same value as the bp.conf VERBOSE entry for bptm, enter:
BPTM_VERBOSE = 0
The entry is the same as setting BPTM logging level in the Logging host
properties to Same as Global.
To log the minimum amount of information for bptm, enter:
BPTM_VERBOSE = -1
The entry is the same as setting BPTM logging level in the Logging host
properties to 0.
To log additional information for bptm, enter a value of 1 through 5:
BPTM_VERBOSE = 1
The entry is the same as setting BPTM logging level in the Logging host
properties to 1.
To log the maximum amount of information for bptm, enter:
BPTM_VERBOSE = 5
The entry is the same as setting BPTM logging level in the Logging host
properties to 5.
For more information about the bptm debug log, see the NetBackup
BPEND_TIMEOUT
Note: If you change this option, verify that the CLIENT_READ_TIMEOUT option
is set to the same or higher value.
Specifies the number of seconds to wait for the bpend_notify script on a client
UNIX master server. Or, set the Backup end notify timeout property in the
Volume I.
Additional configuration 41
NetBackup configuration options
BPSTART_TIMEOUT
Note: If you change this option, verify that the CLIENT_READ_TIMEOUT option
is also set to the same or higher value.
UNIX master server. Or, set the Backup start notify timeout property in the
Volume I.
CHECK_RESTORE_CLIENT
The CHECK_RESTORE_CLIENT entry specifies that the client being restored to
is checked before the restore starts. An unresponsive client can slow the
restores of other clients that have data on the same tapes. This option only
applies to master servers.
Use this option by adding it to the /usr/openv/netbackup/bp.conf file on a
UNIX master server.
CLIENT_CONNECT_TIMEOUT
The CLIENT_CONNECT_TIMEOUT entry specifies the number of seconds that
the server waits before timing out when it connects to a client. Default: 300
seconds.
Use this option by adding it to the /usr/openv/netbackup/bp.conf file on a
UNIX master server. Or, set the Client connect timeout property in the
Timeouts host properties.
CLIENT_PORT_WINDOW
The CLIENT_PORT_WINDOW entry specifies the range of nonreserved ports on
this computer that are used for connecting to NetBackup on other computers.
nonreserved ports.
42 Additional configuration
NetBackup configuration options
If you specify 0 for the first number (default), the operating system determines
the nonreserved port to use.
console.
CLIENT_READ_TIMEOUT
Note: Use this option only on a server or a database agent (such as NetBackup
for Oracle). This option has a reasonable default and has to be changed only if
problems are encountered.
UNIX master server. Or, set the Client read timeout property in the Timeouts
host properties.
Volume I.
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,
CLIENT_RESERVED_PORT_WINDOW
The CLIENT_RESERVED_PORT_WINDOW entry specifies the range of reserved
ports on this computer that are used for connecting to NetBackup on other
Default: Range of 512 through 1023. Note that if you specify 0 for the first
number, a nonreserved port is used instead. The nonreserved port is chosen by
the operating system.
CONNECT_OPTIONS
The CONNECT_OPTIONS entry specifies three options that are designed to
enhance firewall efficiency with NetBackup:
■ Whether the host is connected to using a reserved or a nonreserved port
number.
■ Whether the host is connected to by another server using the traditional
call-back method or using the Veritas Network daemon (vnetd).
■ Whether the host is connected to by using one of the following methods:
■ vnetd or the daemon’s port number,
■ by using vnetd only, or
■ by using the daemon’s port number only.
Use this option by adding it to the /usr/openv/netbackup/bp.conf file on a
UNIX master server. Or, set this option in the Firewall host properties.
Volume I.
CONNECT_OPTIONS = host [ 0 | 1 | 2 ][ 0 | 1 | 2 | 3 ]
[ 0 | 1 | 2 | 3 ]
Where:
■ host is the host name of the server or client to be connected to. host must be
at NetBackup version 4.5 or greater.
44 Additional configuration
NetBackup configuration options
■ The first setting indicates the type of port to use to connect to bpcd on host:
0 = Use a reserved port number.
1 = Use a nonreserved port number. If you select this option, enable Allow
non reserved ports for the selected host. See the Universal Settings dialog
box under Host Properties > Media Servers.
Configuration options are described in Chapter 7 of the NetBackup
Administrator’s Guide, Volume I.
2 = Use the that the DEFAULT_CONNECT_OPTIONS configuration entry
defines (default).
■ The second setting indicates the bpcd call-back method to use to connect to
host:
0 = Use the traditional call-back method (default).
1 = Use the vnetd no call-back method.
2 = Use the that the DEFAULT_CONNECT_OPTIONS configuration entry
defines (default).
See “DEFAULT_CONNECT_OPTIONS” on page 45.
■ The third setting is relevant to NetBackup clients and servers. This setting
indicates the connection method to use to connect to host:
0 = Connect to a daemon on the host using vnetd if possible, otherwise
connect using the traditional port number of the daemon.
1 = Connect to a daemon on the host using vnetd only. This setting turns
on unidirectional bpcd.
2 = Connect to a daemon on the host using the traditional port number of
the daemon only.
3 = Use the that the DEFAULT_CONNECT_OPTIONS configuration entry
defines (default).
See “DEFAULT_CONNECT_OPTIONS” on page 45.
The bp.conf file may contain CONNECT_OPTIONS settings for multiple hosts.
For example:
CONNECT_OPTIONS = shark 0 0 0
bpcd connections to server shark must use a reserved port number and
the traditional call-back method.
Connections to bpdbm, vmd, bprd, and robotic daemons on server
shark can use either vnetd or the daemon’s port number.
CONNECT_OPTIONS = dolphin 1 0 1
bpcd connections to server dolphin must use a nonreserved port
number and the traditional call-back method.
Connections to bpdbm, vmd, bprd, and robotic daemons on server
dolphin must use vnetd.
CONNECT_OPTIONS = perch 0 1 2
Additional configuration 45
NetBackup configuration options
bpcd connections to server perch must use a reserved port number and
vnetd.
CONNECT_OPTIONS = trout 1 1 2
bpcd connections to server trout must use a nonreserved port number
and vnetd.
Connections to bpdbm, vmd, bprd, and robotic daemons on server trout
must use the daemon’s port number.
Refer to “NBJAVA_CONNECT_OPTION” on page 665 in the Administrator’s
Guide, Volume I for connections from the NetBackup-Java Console.
DEFAULT_CONNECT_OPTIONS
The DEFAULT_CONNECT_OPTIONS entry specifies the default values for the
entry is used.
UNIX master server. Or, set this option in the Firewall host properties.
Volume I.
DEFAULT_CONNECT_OPTIONS = [ 0 | 1 ][ 0 | 1 ][ 0 | 1 | 2 ]
Where:
■ The first setting indicates the type of port to use to connect to bpcd on the
remote host:
0 = Use a reserved port number (default).
1 = Use a nonreserved port number. If you select this option, enable Allow
non reserved ports for the selected host. See the Universal Settings dialog
box under Host Properties > Media Servers.
Configuration options are described in Chapter 7 of the NetBackup
Administrator’s Guide, Volume I.
■ The second setting indicates the bpcd call-back method to use to connect to
the remote host:
0 = Use the traditional call-back method.
1 = Use the vnetd no call-back method (default).
■ The third setting indicates the connection method to use to connect to the
remote host:
46 Additional configuration
NetBackup configuration options
Note: If vnetd only (1) is selected as the daemon connection port, the BPCD
connect-back setting is not applicable. If vnetd only (1) is selected as the
daemon connection port, the non-reserved ports setting (1) is always used
regardless of the value of the ports setting.
DISABLE_JOB_LOGGING
The DISABLE_JOB_LOGGING entry disables the logging of the job information
that the NetBackup Activity Monitor requires. Default: job logging occurs.
Use this option by adding it to the /usr/openv/netbackup/bp.conf file on a
UNIX master server.
DISABLE_STANDALONE_DRIVE_EXTENSIONS
The DISABLE_JOB_LOGGING entry can be set using either of the following
methods:
■ Changing the Enable standalone drive extension property in the Media host
properties. (Default: enabled.)
For more information, see Chapter 7 of the NetBackup Administrator’s
Guide, Volume I.
■ By using the nbemmcmd command. (See NetBackup Commands for UNIX and
Linux.)
Disables the nonrobotic drive operations. During a backup, NetBackup does not
automatically attempt to use whatever labeled or unlabeled media it finds in a
nonrobotic drive.
DISALLOW_BACKUPS_SPANNING_MEDIA
The DISALLOW_BACKUPS_SPANNING_MEDIA entry prevents backups from
spanning media. If the end of media is encountered and
DISALLOW_BACKUPS_SPANNING_MEDIA is present, the media is set to FULL.
The operation terminates abnormally. (The action applies to both robotic and
nonrobotic drives.) Default: Backups can span media.
Additional configuration 47
NetBackup configuration options
DISALLOW_CLIENT_LIST_RESTORE
DISALLOW_CLIENT_RESTORE
EMMSERVER
The EMMSERVER entry indicates the master or the media server that acts as the
Enterprise Media Manager server for one or more master servers. The EMM
server contains the database where media and device configuration information
is stored.
The EMMSERVER entry applies only to 6.0 (and later) servers.
EMMSERVER = server_name
48 Additional configuration
NetBackup configuration options
ENABLE_ROBUST_LOGGING
The ENABLE_ROBUST_LOGGING entry helps 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 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.
The maximum size of a log file is set using the NetBackup command vxlogcfg
with parameters NumberOfLogFiles and MaxLogFileSizeKB. 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 disable Robust Logging.
Use this option by adding it to the /usr/openv/netbackup/bp.conf file on a
UNIX master server. Or, set the Robust logging property in the Logging host
properties.
For more information, see Chapter 7 of the NetBackup Administrator’s Guide,
Volume I.
FAILOVER_RESTORE_MEDIA_SERVERS
Applies to NetBackup Enterprise Server:
The FAILOVER_RESTORE_MEDIA_SERVERS entry specifies automatic failover
to another NetBackup server if a server is temporarily inaccessible for a restore.
This failover does not require administrator intervention. Default: NetBackup
does not perform automatic failover. The format for the entry follows:
FAILOVER_RESTORE_MEDIA_SERVERS = failed_host host1 host2
... hostN
Where:
failed_host is the server that is not operational.
host1 ... hostN are the servers that provide failover capabilities.
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.
FORCE_RESTORE_MEDIA_SERVER
Applies to NetBackup Enterprise Server:
The FORCE_RESTORE_MEDIA_SERVER entry forces restores to go to a specific
server, regardless of where the files were backed up. The format for the entry
follows:
FORCE_RESTORE_MEDIA_SERVER = from_host to_host
Where from_host is the server that performed the original backup and to_host is
Stop and restart the NetBackup Request daemon on the master server after
This setting applies to all storage units on the original server. Restores for any
For more information, see “Alternate server restores” on page 687 in the
GENERATE_ENGLISH_LOGS
The GENERATE_ENGLISH_LOGS entry 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:
/usr/openv/netbackup/db/error
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.
50 Additional configuration
NetBackup configuration options
INCOMPLETE_JOB_CLEAN_INTERVAL
The INCOMPLETE_JOB_CLEAN_INTERVAL entry indicates the number of days a
failed restore job can remain in the incomplete state before being moved to the
done state:
INCOMPLETE_JOB_CLEAN_INTERVAL = x
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. (Default: 7
days.)
Use this option by adding it to the /usr/openv/netbackup/bp.conf file on a
UNIX master server or client. Or, set the Move restore job from incomplete
state to done state property in the Global Attributes host properties.
For more information, see Chapter 7 of the NetBackup Administrator’s Guide,
Volume I.
INITIAL_BROWSE_SEARCH_LIMIT
The INITIAL_BROWSE_SEARCH_LIMIT entry specifies the number of days
back that NetBackup searches for files to restore. The value is in days. For
example, to limit the browse range to the seven days before the current date,
specify the following:
INITIAL_BROWSE_SEARCH_LIMIT = 7
This option can be specified on the master server and applies to all NetBackup
clients. It can also be specified on a UNIX client. 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).
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.
Use this option by adding it to the /usr/openv/netbackup/bp.conf file on a
UNIX master server or client.
LIMIT_BANDWIDTH
Note: Read “Notes on bandwidth limits” on page 379 before this option is
changed.
Additional configuration 51
NetBackup configuration options
The LIMIT_BANDWIDTH entry specifies a limit for the network bandwidth that
one or more NetBackup clients use on a network. The actual limiting occurs on
the client side of the backup connection. This feature limits only backups.
Restores are unaffected. Default: The bandwidth is not limited.
Each LIMIT_BANDWIDTH entry specifies the bandwidth value and the IP address
of the clients and networks to which it applies. The syntax is as follows:
LIMIT_BANDWIDTH = xxx.xxx.xxx.xxx yyy.yyy.yyy.yyy zzz
LIMIT_BANDWIDTH = xxx.xxx.xxx.xxx yyy.yyy.yyy.yyy zzz
Where:
■ xxx.xxx.xxx.xxx is the beginning of the IP address range. (For example,
10.0.0.2.)
■ yyy.yyy.yyy.yyy is the end of the IP address range. (For example, 10.0.0.49.)
■ zzz is the bandwidth limitation in kilobytes per second. (For example, 200.) A
value of 0 disables throttling for the individual client or the range of IP
addresses covered by this entry.
Use this option by adding it to the /usr/openv/netbackup/bp.conf file on a
UNIX master server.
■ 128.net.host
Policy B address (16-bit host).
■ net.host
Policy A address (24-bit host).
■ a
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.)
■ You can enter IP addresses as decimal, octal, or hexadecimal numbers.
Numbers that begin with 0 are assumed to be octal; numbers that begin with
0x are hexadecimal; all others are assumed to be decimal.
■ Neither the net nor the host part of an IP address can be zero.
■ Only ordinary IP addresses are accepted (policy A, B & C, no multicast or
reserved addresses).
52 Additional configuration
NetBackup configuration options
■ Do not create multiple entries that specify the same range of IP addresses. If
you do, NetBackup uses the last one it finds. In the following example,
NetBackup uses the second entry.
LIMIT_BANDWIDTH = 111.222.333.1 111.222.333.255 500
LIMIT_BANDWIDTH = 111.222.333.1 111.222.333.255 200
This rule also applies to multiple entries that specify an exact client
address:
LIMIT_BANDWIDTH = 111.222.333.111 111.222.333.111 200
■ Do not specify IP address ranges that overlap one another. Consider the
following:
LIMIT_BANDWIDTH = 111.222.333.1 111.222.333.255 500
LIMIT_BANDWIDTH = 111.222.333.5 111.222.333.255 500
The ranges overlap, and bandwidth limiting results are unpredictable.
■ You can 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 IP address and by
another entry that specifies a range of IP addresses, NetBackup uses the
bandwidth value in the entry with the exact IP address.
The following sets the bandwidth for a range of IP addresses:
LIMIT_BANDWIDTH = 111.222.333.1 111.222.333.255 500
The following sets the bandwidth for a specific address that is within the
range.
LIMIT_BANDWIDTH = 111.222.333.111 111.222.333.111 200
In this case, NetBackup uses the specific entry (bandwidth of 200) for the
client whose address is 111.222.333.111. You can also use this capability to
exclude specific clients from bandwidth limiting. The order of the range and
specific address entries in the bp.conf file is not significant.
If the bandwidth limit for a client is equal to or lower than the value for the
range, the client uses whichever setting is lower:
■ 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.
Examples
■ Configure a bandwidth limit of 500 kilobytes per second for all machines on
the subnet 111.222.333 as follows:
LIMIT_BANDWIDTH = 111.222.333.1 111.222.333.255 500
MEDIA_ID_PREFIX
The MEDIA_ID_PREFIX entry can be set using either of the following methods:
■ Change the Media ID prefix (non-robotic) property in the Media host
properties dialog box. (Default: checkbox clear.)
For more information, see Chapter 7 of the NetBackup Administrator’s
Guide, Volume I.
■ Use the nbemmcmd command.
(See NetBackup Commands for UNIX and Linux.)
The prefix must be one to three alpha-numeric characters. For example:
MEDIA_ID_PREFIX = FEB
The default media ID prefix is A: NetBackup assigns A00000, then A00001, and
so on.
MEDIA_ID_PREFIX = A
54 Additional configuration
NetBackup configuration options
MEDIA_UNMOUNT_DELAY
When MEDIA_UNMOUNT_DELAY is specified, the media unload is delayed for the
UNIX master server. Or, set the Media unmount delay property in the Media
host properties.
Volume I.
MEDIA_UNMOUNT_DELAY = 120
MEDIA_REQUEST_DELAY
The MEDIA_REQUEST_DELAY entry can be set using either of the following
methods:
■ Changing the Media request delay property in the Media host properties.
(Default: 0 seconds.)
For more information, see Chapter 7 of the NetBackup Administrator’s
Guide, Volume I.
■ By using the nbemmcmd command.
See NetBackup Commands for UNIX and Linux.
MEDIA_SERVER
The MEDIA_SERVER entry is similar to the SERVER entry.
clients. However, if the host is not specified as a SERVER, the host has limited
administrative capabilities.
UNIX master server. Or, enter a media server name in the Media Servers list in
Volume I.
MEDIA_SERVER = oak
MPX_RESTORE_DELAY
The MPX_RESTORE_DELAY entry applies to multiplexed restores. It specifies
how long the server waits for restore requests of files and raw partitions that are
Additional configuration 55
NetBackup configuration options
in a set of multiplexed images on the same tape. All the restore requests that are
received within the delay period are included in the same restore operation (one
MPX_RESTORE_DELAY = 60
MUST_USE_LOCAL_DRIVE
The MUST_USE_LOCAL_DRIVE entry can be set using either of the following
methods:
■ Change the Must use local drive property in the General Server host
properties dialog box. (Default: checkbox clear.)
For more information, see Chapter 7 of the NetBackup Administrator’s
Guide, Volume I.
■ Use the nbemmcmd command.
For more information, see NetBackup Commands for UNIX and Linux.
If the client is also a media server and this entry is present, backups for this
client must occur on a local drive. If the client is not a media server, this entry
has no effect.
NBRB_CLEANUP_OBSOLETE_DBINFO
The NBRB_CLEANUP_OBSOLETE_DBINFO entry serves as a performance tuning
option for the Intelligent Resource Manager. This entry indicates the number of
seconds (default: 60) that can elapse between the cleanup of obsolete
information in the NetBackup Resource Broker (nbrb) database.
No equivalent exists in the NetBackup Administration Console host properties.
NBRB_ENABLE_OPTIMIZATIONS
The NBRB_ENABLE_OPTIMIZATIONS entry serves as a performance tuning
option for the Intelligent Resource Manager. This entry indicates whether the
Resource Broker caches states of resource requests. Default: 1 (true).
No equivalent exists in the NetBackup Administration Console host properties.
NBRB_FORCE_FULL_EVAL
The NBRB_FORCE_FULL_EVAL entry serves as a performance tuning option for
the Intelligent Resource Manager. This entry indicates the number of seconds
that can elapse between full evaluations of all NetBackup Resource Broker
56 Additional configuration
NetBackup configuration options
NBRB_REEVAL_PENDING
The NBRB_REEVAL_PENDING entry serves as a performance tuning option for
the Intelligent Resource Manager. This entry indicates the number of seconds
(default: 60) that can elapse between evaluations of the pending request queue.
For example, a pending request queue can include, jobs awaiting resources.
No equivalent exists in the NetBackup Administration Console host properties.
NBRB_REEVAL_PERIOD
The NBRB_REEVAL_PERIOD entry serves as a performance tuning option for the
Intelligent Resource Manager and NetBackup Resource Broker (nbrb).
NBRB_REEVAL_PERIOD indicates the time between evaluations if an
outstanding request is not satisfied, and if no other requests or resources have
been released. Default: 5 minutes passes before the initial request is reevaluated.
No equivalent exists in the NetBackup Administration Console host properties.
NBRB_RETRY_DELAY_AFTER_EMM_ERR
The NBRB_RETRY_DELAY_AFTER_EMM_ERR entry serves as a performance
tuning option for the Intelligent Resource Manager. This entry indicates how
long NetBackup waits after an EMM error before attempting again. (Default: 60
seconds.) The error must be one where a retry is possible. For example, if a
media server is down.
No equivalent exists in the NetBackup Administration Console host properties.
NBRB_MPX_GROUP_UNLOAD_DELAY
The NBRB_MPX_GROUP_UNLOAD_DELAY entry serves as a performance tuning
This entry indicates the number of seconds that the NetBackup Resource Broker
(Default: 10 seconds.) This setting can help avoid unnecessary reloading of tapes
Additional configuration 57
NetBackup configuration options
NetBackup Management > Host Properties > Select master server > Timeouts >
Media mount timeout. See Chapter 7 in the Administrator’s Guide, Volume I for
more details.
NBRB_MPX_GROUP_UNLOAD_DELAY.
RANDOM_PORTS
The RANDOM_PORTS entry specifies whether NetBackup chooses port numbers
randomly or sequentially when it requires one for communication with
NetBackup on other computers.
Use this option by adding it to the /usr/openv/netbackup/bp.conf file on a
UNIX master server or client.
■ 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 and NetBackup uses the random method
for selecting port numbers.
RE_READ_INTERVAL
The RE_READ_INTERVAL entry determines how often NetBackup checks disk
UNIX master server. Or, change the frequency value for the Check the capacity
Volume I.
RE_READ_INTERVAL = 350
REQUIRED_INTERFACE
The REQUIRED_INTERFACE entry specifies the network interface that
NetBackup uses when it connects to another NetBackup client or server. A
58 Additional configuration
NetBackup configuration options
NetBackup client or server can have more than one network interface and, by
default, the operating system determines the one to use. To force NetBackup
connections to be through a specific network interface, use this entry to specify
the network host name of that interface.
In the following example, host1 is the network host name of the interface:
REQUIRED_INTERFACE = host1
You can add this option to the /usr/openv/netbackup/bp.conf file on a
NetBackup client or server. Default: The entry does not exist and the operating
system determines the interface to use.
Now, all backup, restore, and list requests use the fred_nb interface, the server
receives requests from client fred_nb with host name fred_nb, and everything
works as intended.
When barney connects to a client for a backup, the request ideally goes out on
the barney_nb interface and over the backup network. This assumes that barney
and the network are set up for this. However, if this configuration is not in place,
barney can send the request out on the barney interface and over the regular
network. The client now receives the request from barney rather than
barney_nb and refuses it as coming from an invalid server.
One way to solve this problem is to add SERVER = barney to the bp.conf file
on the client. The client now accepts requests from barney, but NetBackup
traffic is still on the regular network.
A better solution is to add the following entry to the bp.conf file on barney:
REQUIRED_INTERFACE = barney_nb
Now, when barney connects to a client, the connection is always through the
barney_nb interface and everything works as intended.
REQUIRED_NETWORK
The REQUIRED_NETWORK entry specifies the required route for backup traffic in
an environment where the network traffic is segregated.
For example, an environment may contain a production network at
145.21.14.0 and a backup network at 192.132.28.0. To indicate that
NetBackup should use only the backup network, add the following entry in the
bp.conf file:
REQUIRED_NETWORK = 192.132.28.0
Note: If the variable is set and the network is not available, all connections fail
and no backups are performed.
SERVER
The first SERVER entry in the bp.conf file must point to that master server
itself. During installation, SERVER is automatically set to the name of the
system on which you install the NetBackup master server software.
The SERVER option must be present in the /usr/openv/netbackup/bp.conf
file on all NetBackup UNIX servers and clients. It is the only required entry in
these bp.conf files. This option is not used in $HOME/bp.conf files on a client.
60 Additional configuration
NetBackup configuration options
Note: This section discusses the bp.conf entries on the server. However, note
that every SERVER entry in a client bp.conf file must be a NetBackup master or
media server. That is, each system 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.
The first SERVER entry in the bp.conf files 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 servers that belong to another cluster, in which case the bp.conf on the
media server should have SERVER entries for those servers as well.
The following is an example bp.conf file on a media server:
SERVER = Master_server (for this media server)
SERVER = NBU_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 media
server cluster.
If you modify or add a SERVER entry in the bp.conf file on the master server,
stop and restart both the NetBackup request daemon (bprd) and NetBackup
Additional configuration 61
NetBackup configuration options
Note: If you modify the first bp.conf SERVER entry (the master server) on a
media server, the EMM database also needs to be updated. To update the EMM
database, run nbemmcmd -updatehost to change the master server for a
media server.
SERVER_PORT_WINDOW
The SERVER_PORT_WINDOW entry specifies the range of nonreserved ports on
Default range: 1024 through 5000. This option can also be useful on the clients
UNIX master server. Or, change the Server port window range property in the
Volume I.
SERVER_RESERVED_PORT_WINDOW
The SERVER_RESERVED_PORT_WINDOW entry specifies the range of local
UNIX master server. Or, change the Server reserved port window range
Volume I.
62 Additional configuration
NetBackup configuration options
SKIP_RESTORE_TO_SYMLINK_DIR
The SKIP_RESTORE_TO_SYMLINK_DIR entry 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.
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.
and UNLINK_ON_OVERWRITE, symbolic links that the restore job comes across
are unlinked before checking, and the files and directory are restored.
SERVER_CONNECT_TIMEOUT
Applies to NetBackup Enterprise Server:
SERVER_CONNECT_TIMEOUT specifies the number of seconds that the master
server waits before timing out when it connects to a media server. Default:
Timeout period is 30 seconds.
Additional configuration 63
NetBackup configuration options
SERVER_CONNECT_TIMEOUT = 60
UNLINK_ON_OVERWRITE
When a UNIX client indicates Overwrite existing files as a restore option,
UNLINK_ON_OVERWRITE forces NetBackup to first check for the existence of a
file to be restored, unlink the file if it exists, then 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.
when restoring symbolic links, hard links, or special files (CHR, BLK, and FIFO).
However, NetBackup does not unlink when it restores normal files or directories.
This can be a problem with symbolic links because NetBackup follows the
and UNLINK_ON_OVERWRITE, symbolic links that the restore job comes across
are unlinked before checking, and the files and directory are restored.
USE_VXSS
The USE_VXSS entry specifies whether the local system uses Symantec product
UNIX master server. Or, change the Symantec product authentication and
Prohibit, or Automatic.
Volume I.
Where:
REQUIRED indicates that the local system always uses Symantec product
authentication and authorization. Connections from systems not using
Symantec product authentication and authorization are rejected.
PROHIBITED indicates that the local system never uses Symantec product
authentication and authorization. Connections from systems using Symantec
product authentication and authorization are rejected (default).
AUTOMATIC indicates that the local system negotiates with the remote system
whether to use Symantec product authentication and authorization.
If USE_VXSS = AUTOMATIC is specified, VXSS_NETWORK entries can be used
to require or prohibit Symantec product authentication and authorization
connections with specified remote systems. See VXSS_NETWORK for an
example using USE_VXSS = AUTOMATIC.
VERBOSE
Used for debugging purposes, the VERBOSE option controls the amount of
UNIX master server. Or, change the Global logging level property in the Logging
host properties.
Volume I.
VERBOSE = [ 0 | 1 | 2 | 3 | 4 | 5 ]
VXSS_NETWORK
The VXSS_NETWORK entry identifies whether a specific network or remote
system must or must not use Symantec product authentication and
authorization with the local system.
Additional configuration 65
NetBackup configuration options
UNIX master server. Or, change the networks list property in the Access Control
host properties.
Volume I.
specified.
Possible values:
■ 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 of the remote systems followed by a dot.
The optional second value can be one of the following keywords:
■ AUTOMATIC
■ REQUIRED
■ PROHIBITED
Note: If a system is specified by more than one VXSS_NETWORK entry, the first
occurance takes precedence.
Example
USE_VXSS = AUTOMATIC
VXSS_NETWORK = fred.mycompany.com
VXSS_NETWORK = .theircompany.com
66 Additional configuration
NetBackup configuration options
NetBackup uses internal software defaults for all options in the bp.conf file,
except SERVER. During installation, NetBackup sets the SERVER option to the
name of the master server where the software is installed.
If a UNIX system is both a client and a server, both the server and the client
Each nonroot user on a UNIX client can have a personal bp.conf file in their
$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
Additional configuration 67
NetBackup configuration options
users.
The following topics describe the options that you can specify in the
Note: PC clients provide similar options that you can change either through the
client-user interface or in a configuration file, depending on the client. For
instructions, see the online help in the Backup, Archive, and Restore client
interface.
ALLOW_NON_RESERVED_PORTS
The ALLOW_NON_RESERVED_PORTS entry specifies that the NetBackup client
daemon (bpcd) can accept remote connections from non-privileged ports (port
numbers 1024 or greater). If this entry is not present, then bpcd requires
remote connections to come from privileged ports (port numbers less than
1024). This option can be useful when NetBackup clients and servers are on
UNIX client.
cd /usr/openv/netbackup/bin/admincmd
AUTHENTICATION_DOMAIN
The AUTHENTICATION_DOMAIN entry defines a set of VxSS authentication
information.
If a media server or client does not define an authentication domain, it uses the
UNIX client. Or, set the Authentication Domains in the Access Control
68 Additional configuration
NetBackup configuration options
For more information, see “Authentication Domain tab within the Access
Control properties” on page 368 in the NetBackup Administrator’s Guide,
Volume I.
BPARCHIVE_POLICY
The BPARCHIVE_POLICY entry specifies the name of the policy to use for user
archives. Default: BPARCHIVE_POLICY is not in any bp.conf file and
NetBackup uses the first policy that it finds that has the client and a user
archive schedule.
For example:
BPARCHIVE_POLICY = arch_1
BPARCHIVE_SCHED
The BPARCHIVE_SCHED entry specifies the name of the schedule for user
archives. Default: BPARCHIVE_SCHED is not in any bp.conf file and NetBackup
uses the first archive schedule in the first policy that it finds that has this client.
For example
BPARCHIVE_SCHED = user_arch1
BPBACKUP_POLICY
The BPBACKUP_POLICY entry specifies the name of the policy name to use for
user backups. Default: BPBACKUP_POLICY, is not in any bp.conf file and
NetBackup uses the first policy it finds that has both the client and a user
backup schedule.
For example:
BPBACKUP_POLICY = userback_1
Additional configuration 69
NetBackup configuration options
BPBACKUP_SCHED
The BPBACKUP_SCHED entry specifies the name of the schedule to use for user
backups. Default: BPBACKUP_SCHED is not in any bp.conf file and NetBackup
uses the first policy it finds that has both the client and a user backup schedule.
For example:
BPBACKUP_SCHED = user_back1
BUSY_FILE_ACTION
The BUSY_FILE_ACTION entry directs the action that NetBackup performs on
Directs NetBackup to exclude the busy file from busy file being
processed.
BUSY_FILE_DIRECTORY
The BUSY_FILE_DIRECTORY entry specifies the path to the busy-files working
directory when busy-file processing is enabled. Default:
70 Additional configuration
NetBackup configuration options
BUSY_FILE_NOTIFY_USER
The BUSY_FILE_NOTIFY_USER entry specifies the recipient of the busy file
root.
BUSY_FILE_PROCESSING
The BUSY_FILE_PROCESSING entry allows the user to control NetBackup
For more information, see “Busy file processing (UNIX clients only)” on
UNIX client.
CLIENT_NAME
The CLIENT_NAME entry specifies the name of the client as it is known to
NetBackup. There can be one CLIENT_NAME entry and it must match the name
that is used in any policy that backs up the client. An exception is for an
alternate-client restore, where the name must match that of the client whose
installation scripts.
UNIX client.
Additional configuration 71
NetBackup configuration options
If the value is not in any bp.conf file, NetBackup uses the value that is returned
by the gethostname() library function.
CLIENT_PORT_WINDOW
The CLIENT_PORT_WINDOW entry specifies the range of nonreserved ports on
this computer that are used for connecting to NetBackup on other computers.
For more information, see “CLIENT_PORT_WINDOW” on page 41.
CLIENT_READ_TIMEOUT
Th CLIENT_READ_TIMEOUT entry specifies the number of seconds for the
CLIENT_RESERVED_PORT_WINDOW
The CLIENT_RESERVED_PORT_WINDOW entry specifies the range of reserved
ports on this computer that are used for connecting to NetBackup on other
computers.
For more information, see “CLIENT_RESERVED_PORT_WINDOW” on page 43.
COMPRESS_SUFFIX
CRYPT_CIPHER
The CRYPT_CIPHER entry on the client takes one the following values:
■ AES-128-CFB (used when no method is specified; default)
■ AES-256-CFB
■ BF-CFB
■ DES-EDE-CFB
This client property can also be configured on the Encryption host properties
dialog box for each client.
CRYPT_KIND
Note: The CRYPT_KIND entry applies to 5.1 clients with the NetBackup
Encryption option installed. For information on NetBackup Encryption, see the
NetBackup Encryption Administrator’s Guide.
Additional configuration 73
NetBackup configuration options
CRYPT_OPTION
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
CRYPT_STRENGTH
74 Additional configuration
NetBackup configuration options
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
CRYPT_LIBPATH
The CRYPT_KEYFILE 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 you run
the bpinst_crypt command on the NetBackup master server.
Do not alter the entry or create it manually unless it has been accidentally
deleted.
■ The following is the default value on UNIX systems:
/usr/openv/lib/
CRYPT_KEYFILE
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 you run the
bpinst_crypt command on the NetBackup master server.
Additional configuration 75
NetBackup configuration options
Do not alter the entry or create it manually unless it has been accidentally
deleted. The default values follow:
■ On UNIX systems: /usr/openv/netbackup/keyfile
■ 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.
DISALLOW_SERVER_FILE_WRITES
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 bp.conf file on the
client.
You can add this option to the /usr/openv/netbackup/bp.conf file on a
UNIX client. By default, server writes are allowed.
DO_NOT_RESET_FILE_ACCESS_TIME
GENERATE_ENGLISH_LOGS
The GENERATE_ENGLISH_LOGS entry 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.
You can add this option to the /usr/openv/netbackup/bp.conf file on
NetBackup servers and clients.
76 Additional configuration
NetBackup configuration options
IGNORE_XATTR
By default, extended attribute files (Solaris 9 or greater) and named data
streams are backed up. To exclude extended attributes and named data streams
formerly IGNORE_XATTR_SOLARIS.)
If IGNORE_XATTR is present in the bp.conf file, NetBackup does not check for
For more information, see “Backup and restore of extended attribute files and
INFORMIX_HOME
The INFORMIX_HOME entry specifies the path to the Informix home directory
INITIAL_BROWSE_SEARCH_LIMIT
The INITIAL_BROWSE_SEARCH_LIMIT entry reduces the default number of
clients.
KEEP_DATABASE_COMM_FILE
The KEEP_DATABASE_COMM_FILE entry causes NetBackup to keep database
agent logs for seven days. Default: NetBackup keeps database agent logs for only
one day.
You can add KEEP_DATABASE_COMM_FILE to the
/usr/openv/netbackup/bp.conf file on a UNIX database agent. For
example, add it to a client that is running NetBackup for Informix.
KEEP_LOGS_DAYS
The KEEP_LOGS_DAYS entry specifies how long to keep job and progress logs of
the NetBackup Java program, Backup, Archive, and Restore. NetBackup writes
these files in the usr/openv/netbackup/logs/user_ops/username/jobs
and /usr/openv/netbackup/logs/user_ops/username/logs directories.
A directory exists for each user that uses the Backup, Archive, and Restore
Additional configuration 77
NetBackup configuration options
program. This entry also controls the number of days to keep the
/usr/openv/netbackup/logs/user_ops/nbjlogs.
on a UNIX client.
LIST_FILES_TIMEOUT
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
of 30 minutes.
LOCKED_FILE_ACTION
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 LOCKED_FILE_ACTION is set to SKIP, NetBackup skips the files
that currently have mandatory locking set by another process. NetBackup logs a
message to this effect.
You can add LOCKED_FILE_ACTION to the
/usr/openv/netbackup/bp.conf files on a UNIX client. Default: NetBackup
waits for files to become unlocked.
MEDIA_SERVER
The MEDIA_SERVER entry specifies that the listed machine is a media server
only. Machines that are listed as media servers can back up and restore clients,
but have limited administrative privileges.
78 Additional configuration
NetBackup configuration options
MEGABYTES_OF_MEMORY
NFS_ACCESS_TIMEOUT
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.
You can add this option to the /usr/openv/netbackup/bp.conf file on a
UNIX client. Default: Timeout period is five seconds.
RANDOM_PORTS
The RANDOM_PORTS entry specifies whether NetBackup chooses port numbers
randomly or sequentially when it requires one for communication with
NetBackup on other computers.
For more information, see “RANDOM_PORTS” on page 57
RESTORE_RETRIES
Additional configuration 79
NetBackup configuration options
REQUIRED_INTERFACE
The REQUIRED_INTERFACE entry specifies the network interface that
SERVER_PORT_WINDOW
The SERVER_PORT_WINDOW entry specifies the range of nonreserved ports on
which this computer accepts connections from NetBackup on other computers.
SERVER
Applies to NetBackup Enterprise Server only.
The SERVER entry defines the list of NetBackup master servers and media
servers that can access the NetBackup client. During client installation, the
SERVER is 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 using the MEDIA_SERVER option.)
Note: Every SERVER entry in a client bp.conf file must be a NetBackup master
or media server. That is, each system 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.
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.
80 Additional configuration
NetBackup configuration options
SYBASE_HOME
The SYBASE_HOME entry specifies the path to the Sybase home directory and is
required when using NetBackup for Sybase to back up Sybase databases.
Default: SYBASE_HOME is not in the bp.conf file.
You must add SYBASE_HOME to the /usr/openv/netbackup/bp.conf file on
a NetBackup for Sybase client.
Note: This entry is not required to back up the Sybase ASA that NetBackup uses
as part of the NetBackup catalog.
USE_CTIME_FOR_INCREMENTALS
Do not use these options if you are running Storage Migrator on the system.
Setting these options causes the atime for files to be updated every time they are
backed up. When the atime is updated, it appear as if the files are frequently
used and prevents Storage Migrator from selecting the files for migration.
USE_FILE_CHG_LOG
The USE_FILE_CHG_LOG entry specifies whether NetBackup utilitzes the file
the client. Or, set the Use VxFS File Change Log for Incremental Backups
USE_VXSS
The USE_VXSS entry specifies whether the local system uses VxSS.
Additional configuration 81
NetBackup configuration options
USEMAIL
The USEMAIL entry specifies the email address where NetBackup sends status
on the outcome of operations for a UNIX client. Default: USEMAIL is not present
in any bp.conf file and no email is sent.
Note: You can use multiple addresses or an email alias as long as no blanks or
white space appear between them.
VERBOSE
The VERBOSE entry causes NetBackup to include more information in its logs.
Default: Disabled.
UNIX client.
VXSS_NETWORK
The VXSS_NETWORK entry identifies whether a specific network or remote
system must or must not use VxSS with the local system.
If a media server or client does not define a VxSS network, it uses the VxSS
file on a UNIX client. Or, by adding the network to the Networks list in the
82 Additional configuration
NetBackup configuration options
For more information, see “Networks list” on page 366 in the NetBackup
Administrator’s Guide, Volume I.
CLIENT_NAME = freddie
USEMAIL = abc@bdev.com
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
Note: A root user cannot have a personal bp.conf file. For root users,
NetBackup uses the /usr/openv/netbackup/bp.conf file.
USEMAIL = mars@bdev.com
BPBACKUP_POLICY = user1
BPBACKUP_SCHED = userback
BPARCHIVE_POLICY = user1
BPARCHIVE_SCHED = userarch
LIST_FILES_TIMEOUT = 10
CLIENT_NAME = alternate_client_name
ACS_mediatype
ACS_mediatype = Media_Manager_mediatype
ACS_SEL_SOCKET
ACS_SEL_SOCKET = socket_name
ACS_CSI_HOSTPORT
ACS_CSI_HOSTPORT = ACS_library_software_hostname socket_name
ports. Note that TCP source ports are not restricted. Also see
“ACS_SSI_INET_PORT” on page 84 and “ACS_TCP_RPCSERVICE /
ACS_UDP_RPCSERVICE” on page 85.
For example, a NetBackup media server has two ACSLS servers (ACSLS_1 and
ACSLS_2) behind firewalls. Both servers listen for queries on port 30031 and the
firewall allows traffic through this port. The vm.conf entries are as follows:
ACS_TCP_RPCSERVICE
ACS_CSI_HOSTPORT = ACSLS_1 30031
Each acsssi process sends queries to the respective ACSLS server’s port 30031,
and the ACSLS server is configured to listen for queries on this port.
ACS_SSI_HOSTNAME
ACS_SSI_HOSTNAME = host
ACS_SSI_INET_PORT
ACS_SSI_INET_PORT = ACS_library_software_hostname socket_name
ACS library host. Do not use the IP address of the ACS library host for this
parameter.
The socket_name entry specifies the port that acsssi uses for incoming
ACSLS responses. Valid values are 1024 - 65535 and 0. This value must be
A value between 1024 - 65535 indicates the number to be used as the TCP port
0 (zero) indicates that the previous behavior (allow the port to be dynamically
are commonly used with firewall implementations. With these three entries in
the vm.conf file, TCP connections use the designated destination ports. Note
that TCP source ports are not restricted. Also see “ACS_CSI_HOSTPORT” on
Additional configuration 85
NetBackup configuration options
For example, a NetBackup media server has two ACSLS servers (ACSLS_1 and
ACSLS_2) behind firewalls. Ports 30032 and 300033 have been opened in the
firewall for acsssi to ACSLS server communication. The entries would be as
follows:
ACS_TCP_RPCSERVICE
The NetBackup media server starts two acsssi processes. One listens for
ACSLS_1 responses on port 30032, and the other listens on port 30033 for
responses from ACSLS_2.
ACS_SSI_SOCKET
ACS_SSI_SOCKET = ACS_library_software_hostname socket_name
ACS_TCP_RPCSERVICE / ACS_UDP_RPCSERVICE
ACS_TCP_RPCSERVICE
ACS_UDP_RPCSERVICE
Only one entry should be entered into vm.conf. NetBackup uses UDP if both
on page 84).
ADJ_LSM
ADJ_LSM = robot_num ACS_ID,LSM_ID ACS_ID,LSM_ID
Without this entry present, NetBackup assumes that all LSMs are
interconnected with pass-through ports, except for the first LSM and the last
LSM. The LSMs are interconnected in a line formation.
robot_num is the robot number. ACS_ID and LSM_ID are the coordinates of
the LSM.
For example, the following entries are required to specify the physical layout of
LSM interconnections for robot number 700 (Figure 1-2 on page 87):
Interconnections for
Robot 700 1
0 2
5 3
API_BARCODE_RULES
API_BARCODE_RULES
Barcode rules are especially useful when multiple generations of the same tape
For example STK 9940A and STK 9940B drives use STK1R media, but write data
at different densities. The drive must be configured using different drive types
such as hcart or hcart2. You can specify a barcode rule for a series of barcodes to
configure some of the media as hcart2. Other STK1R media not in this barcode
range are configured as hcart (the default for STK1R). Without this entry, a
robot inventory operation configures all media of type STK1R as either hcart or
AUTHORIZATION_REQUIRED
AUTHORIZATION_REQUIRED
This entry specifies that NetBackup should use the vm.conf file SERVER entry
to control which hosts can monitor and control devices on this host. This entry
is read and interpreted on the media server on which the NetBackup vmd service
runs.
88 Additional configuration
NetBackup configuration options
If this entry is specified in vm.conf, the vm.conf file also must include a
SERVER entry for every media server that controls devices on this host.
For maximum security, Symantec recommends that you use this entry and
SERVER entries.
This entry is read and interpreted on media servers on which the NetBackup
AUTO_PATH_CORRECTION
AUTO_PATH_CORRECTION = YES|NO
If this entry is specified in vm.conf, it specifies whether automatic device path
remapping is enabled or disabled.
If the value is NO, the device configuration remains unchanged when the
NetBackup Device Manager service (ltid) is started. Therefore, the saved
device configuration may be different than the actual configuration after you
change devices and restart the server.
If the value is YES, NetBackup tries to discover attached devices and then
automatically update the device configuration for any device paths that are
incorrect. On Windows computers, this entry is read and interpreted on the host
on which the NetBackup Device Manager service runs. On UNIX and Linux
computers, this entry is read and interpreted on the host on which ltid runs.
Device path remapping is enabled by default on Windows and Linux servers. It is
disabled by default on all other servers.
AUTO_UPDATE_ROBOT
AUTO_UPDATE_ROBOT
Use this entry to inject media automatically from the Media Access Port (MAP)
into a TL8 or TLD robot and update the EMM database. Media are injected if the
This entry only operates with the TL8 or TLD robots that post a unit attention
Symantec recommends that this entry not be used with partitioned libraries.
Most robotic libraries with multiple partitions do not post a unit attention when
AVRD_PEND_DELAY
AVRD_PEND_DELAY = number_of_seconds
Additional configuration 89
NetBackup configuration options
AVRD_SCAN_DELAY
AVRD_SCAN_DELAY = number_of_seconds
If this entry is specified in vm.conf, avrd waits number_of_seconds between
normal scan cycles. This entry is read and interpreted on the host on which
avrd runs.
Use this entry to minimize tape mount times. Without this entry, NetBackup
delays mount requests by an average of 7.5 seconds.
The minimum for number_of_seconds is 1. The maximum is 180. A value of zero
is converted to 1 second. The default value is 15 seconds. If a value is used that is
greater than the default, NetBackup delays mount requests and drive status
updates in the Device Monitor.
CLEAN_REQUEST_TIMEOUT
CLEAN_REQUEST_TIMEOUT = minutes
Use this entry to specify how long NetBackup waits for a drive to be cleaned
before it removes the cleaning request from the cleaning queue. Unprocessed
requests to clean a drive are removed from the queue after 30 minutes.
minutes can be from 1 to 144000 (100 days). The default value is 30 and a value
of zero is converted to the default value of 30.
CLIENT_PORT_WINDOW
CLIENT_PORT_WINDOW = start end
Use this entry to specify the range of non-reserved ports on this host that are
used to connect to vmd on other hosts. This entry is read and interpreted on the
host on which vmd runs.
90 Additional configuration
NetBackup configuration options
For example, the following entry permits ports from 4800 through 5000:
CLIENT_PORT_WINDOW = 4800 5000
The operating system determines the non-reserved port to use in the following
cases:
■ A CLIENT_PORT_WINDOW entry is not specified.
■ A value of zero is specified for start.
CLUSTER_NAME
CLUSTER_NAME = cluster_alias
This entry and the following two entries determine the name other NetBackup
servers and clients should use when they refer to this server:
MM_SERVER_NAME = host_name
REQUIRED_INTERFACE = host_name
CONNECT_OPTIONS
CONNECT_OPTIONS = server_name 0 0 [0|1|2]
Add this entry in vm.conf to specify the options that enhance firewall
efficiency with NetBackup. Server connection options can be any of the
following: use vnetd or the daemon’s port number, use only vnetd, or use only
the daemon’s port number.
CONNECT_OPTIONS entries can be specified for multiple servers.
You can also use a similar entry and add it to the NetBackup configuration file
(/usr/openv/netbackup/bp.conf). For more information, see
“CONNECT_OPTIONS” on page 43.
server_name is the name of the media server to connect to. The server must be
at NetBackup level 4.5 or higher for vnetd to operate correctly.
The first and second options currently are not used. Specify zero for these
options.
Additional configuration 91
NetBackup configuration options
Examples
The following entry specifies to use either vnetd or the daemon’s port number
to connect to server shark:
CONNECT_OPTIONS = shark 0 0 0
The following entry specifies to use vnetd only to connect to server dolphin:
CONNECT_OPTIONS = dolphin 0 0 1
The following entry specifies to use the daemons’s port number only to connect
to server perch:
CONNECT_OPTIONS = perch 0 0 2
DAS_CLIENT
DAS_CLIENT = client_name
DAYS_TO_KEEP_LOGS
DAYS_TO_KEEP_LOGS = days
If this entry is specified in vm.conf, specify the number of days to keep debug
logs before vmd deletes them. This entry is read and interpreted on the hosts
where vmd is running.
A value of zero means that the logs are not deleted. The default is zero. This
entry does not impact debug logs created by Unified Logging.
For more information about Unified Logging, see the NetBackup
Troubleshooting Guide for UNIX, Windows, and Linux.
92 Additional configuration
NetBackup configuration options
EMM_RETRY_COUNT
EMM_RETRY_COUNT = number_of_retries
The vmd and the ltid daemons use this entry to determine how many times to
retry requests to the NetBackup Enterprise Media Manager.
Default: one retry.
Only change the value of this vm.conf file entry when directed to do so by your
NetBackup support representative. If you add this entry to the vm.conf file or
change this value, you must restart the vmd and the ltid daemons / services.
EMM_CONNECT_TIMOUT
EMM_CONNECT_TIMOUT = number_of_seconds
This value applies for broken connections between the vmd and the ltid
daemons and the NetBackup Enterprise Media Manager. The vmd and the ltid
daemons use this entry to determine for how long they should try to reconnect
to the NetBackup Enterprise Media Manager.
Default: 20 seconds.
Only change the value of this vm.conf file entry when directed to do so by your
NetBackup support representative. If you add this entry to the vm.conf file or
change this value, you must restart the vmd and the ltid daemons / services.
EMM_REQUEST_TIMOUT
EMM_REQUEST_TIMOUT = number_of_seconds
The vmd and the ltid daemons use this entry to determine how many seconds
to allow a request to the NetBackup Enterprise Media Manager to complete.
Default: 300 seconds.
Only change the value of this vm.conf file entry when directed to do so by your
NetBackup support representative. If you add this entry to the vm.conf file or
change this value, you must restart the vmd and the ltid daemons / services.
ENABLE_ROBOT_AUTH
NetBackup encourages the use of Symantec Product Authentication and
Authorization for NetBackup Access Control (NBAC) instead of legacy security
implementations.
For information about the ENABLE_ROBOT_AUTH configuration entry, see the
NetBackup 6.0 documentation. For information on Symantec Product
Authentication and Authorization, see the NetBackup Security and Encryption
Guide.
Additional configuration 93
NetBackup configuration options
INVENTORY_FILTER
INVENTORY_FILTER = robot_type robot_number mode value1 [value2 ...]
Note: This entry may be required for an ACS robot and the ACS library software
host was an STK Library Station. Newer versions of STK Library Station allow
robot inventory commands to function correctly so filters are not required.
MAP_ID
MAP_ID = robot_num map_ID
If the MAP is not available or the vm.comf file does not contain this entry,
NetBackup uses the default MAP selection process. By default, NetBackup uses
the smallest MAP that can hold the number of media to be ejected.
algorithm rather than the MAP that is specified in the MAP ID entry. For more
The following example specifies the MAP ID for ACS robot number 700. The ACS
94 Additional configuration
NetBackup configuration options
MAP_CONTINUE_TIMEOUT
MAP_CONTINUE_TIMEOUT = seconds
This entry applies only when the vmchange command is used and the -w option
is specified. The default timeout value for seconds is 300 (5 minutes).
seconds cannot be zero and values greater than 1200 (20 minutes) may cause
the robotic daemon to cancel the operation.
If this entry is specified in vm.conf, the SCSI robotic daemons wait the
specified number of seconds before they time out. A timeout can occur while
waiting for a reply from the user to continue after removing volumes from the
media access port. A timeout results in the operation being aborted.
This entry is read and interpreted on the host on which the SCSI-controlled
robotic daemon or process runs.
Caution: Non-mount activities such as a robotic inventory can not occur during
this timeout period.
MEDIA_ID_BARCODE_CHARS
MEDIA_ID_BARCODE_CHARS = robot_num barcode_length media_ID_rule
Note: To use this entry, the robot must support barcodes and the robot type
cannot be an API robots.
NetBackup extracts (from left to right). For example, 2 in a field extracts the
second character from the barcode. The numbers can be specified in any order.
If the pound sign (#) prefixes a character, that character is inserted in that
position in the generated ID. Any alphanumeric characters must be valid for a
media ID. Use rules to create media IDs of many different formats. However, if
the generated media ID is different from the label on the media, media
management may be more difficult.
The following is an example rule and the resulting generated media ID:
Barcode on the tape: 032945L1
MEDIA_ID_PREFIX
MEDIA_ID_PREFIX = media_id_prefix
If this entry is specified in vm.conf, it defines the media ID prefixes to use for
media without barcodes. This entry is read and interpreted on the host where
vmcheckxxx and vmupdate are running as part of the robot inventory
operation.
The best way to add media to a robot is to use the Robot Inventory Update
Volume Configuration operation.
MM_SERVER_NAME
MM_SERVER_NAME = host_name
This entry determines the name other NetBackup servers and clients should use
when they refer to this server:
CLUSTER_NAME = cluster_alias
REQUIRED_INTERFACE = host_name
PREFERRED_GROUP
NetBackup encourages the use of Symantec Product Authentication and
Authorization for NetBackup Access Control (NBAC) instead of legacy security
implementations.
For information about the PREFERRED_GROUP configuration entry, see the
NetBackup 6.0 documentation. For information on Symantec Product
Authentication and Authorization, see the NetBackup Security and Encryption
Guide.
PREVENT_MEDIA_REMOVAL
Applies to the TL8 robots only.
Specifying this entry changes the default operation for TL8 robots. Without this
If this entry is specified in vm.conf, TL8 robots execute the SCSI command
PREVENT MEDIUM REMOVAL. The robot's main door or the MAP cannot be
This entry is read and interpreted on the host on which the TL8 robot control
To override PREVENT_MEDIA_REMOVAL
Do one of the following:
◆ Use the test utility and run allow media removal.
◆ Use inject or eject for access, when volumes are added or moved.
RANDOM_PORTS
RANDOM_PORTS = YES|NO
Use this entry to specify whether NetBackup chooses port numbers randomly or
highest number in the allowed range, then tries the next highest, and so on until
a port is available.
Additional configuration 97
NetBackup configuration options
REQUIRED_INTERFACE
REQUIRED_INTERFACE = host_name
This entry and the following two entries determine the name other NetBackup
servers should use when they refer to this server:
CLUSTER_NAME = cluster_alias
MM_SERVER_NAME = host_name
SERVER
SERVER = host_name
SERVER entries in the vm.conf file are used for NetBackup media server
security. The SERVER entries work with the AUTHORIZATION_REQUIRED entry
to control which hosts can monitor and control devices on this host.
If the AUTHORIZATION_REQUIRED entry exists, the vm.conf file must include
a SERVER entry for every media server that controls devices on this host. If the
vm.conf file contains any SERVER entries, it also must include a SERVER entry
for itself or it cannot manage its own devices.
If no AUTHORIZATION_REQUIRED entry exists and no SERVER entries exist, any
NetBackup server can monitor and control devices on this host.
For security, the entries that allow only specific hosts to access the devices must
be added remotely.
98 Additional configuration
NetBackup configuration options
This entry is read and interpreted on media servers on which the NetBackup
vmd service runs.
SSO_DA_REREGISTER_INTERVAL
SSO_DA_REREGISTER_INTERVAL = minutes
SSO_DA_RETRY_TIMEOUT
SSO_DA_RETRY_TIMEOUT = minutes
SSO_HOST_NAME
SSO_HOST_NAME = host_name
This entry specifies the name that the current host uses to register, reserve, and
release shared drives with EMM/DA. The default is the local host name.
TLH_mediatype
TLH_mediatype = Media_Manager_mediatype
If this entry is specified in vm.conf, IBM ATL media types in Tape Library
Half-inch (TLH) robots are mapped to Media Manager media types. This entry is
read and interpreted on the host where vmcheckxxx and vmupdate are
running as part of the robot inventory operation.
TLM_mediatype
TLM_mediatype = Media_Manager_mediatype
VERBOSE
If this entry is specified in vm.conf, all Media Manager components on the host
DAYS_TO_KEEP_LOGS entry.
Note: If you use dynamic addressing, remember that the NetBackup servers still
require fixed IP addresses and host names.
100 Additional configuration
Dynamic host name and IP addressing
Note: All clients configured to use dynamic addressing and host names must
trust each other, similar to the NetBackup altnames feature.
The following steps are required to support the configurations that use dynamic
IP addressing for NetBackup. Before you make changes to a configuration, read
this entire section.
1 Configure your network to use a dynamic IP addressing protocol like DHCP.
NetBackup requires that IP addresses of clients have a network host name.
Be sure to define network host names for the range of dynamic IP addresses
in the hosts file, NIS, and (or) DNS on your network.
2 Determine the NetBackup client names for the machines that have dynamic
IP addresses and network host names.
These NetBackup client names are used in step 3 and step 6. Each
NetBackup client must have a unique NetBackup client name. The
NetBackup client name that is assigned to a client is permanent—do not
change it.
3 Make changes on the master server:
a Create NetBackup policies with client lists that include the names from
step 2.
b Create entries in the NetBackup client database for the client names
from step 2.
Create the entries by using the bpclient command.
4 Make changes on each dynamic NetBackup Windows client:
Start the Backup, Archive, and Restore user interface on the client. Select
File > NetBackup Client Properties. The NetBackup Client Properties dialog
box appears. Select the General tab. Change the Client Name to the correct
NetBackup client name for the machine.
5 On the master server, enable the Announce DHCP Interval option:
Open the NetBackup Administration Console and navigate to the Host
Properties for clients. (Select NetBackup Management > Host Properties >
Clients.) Open the client properties for the Windows client(s). Under the
Windows Client host properties, select Network. Check the Announce DHCP
Interval checkbox.
6 Make changes on each dynamic NetBackup UNIX client:
a Modify the bp.conf file to include a CLIENT_NAME entry with the
correct NetBackup client name for the machine.
Additional configuration 101
Dynamic host name and IP addressing
123.123.123.71 dynamic01
123.123.123.72 dynamic02
123.123.123.73 dynamic03
123.123.123.79 dynamic09
Assign a unique NetBackup client name to each NetBackup client that might use
one of these dynamic IP addresses. The NetBackup client name that is assigned
to a client is permanent and should not be changed. The client name that is
assigned to NetBackup clients with dynamic IP addressing must not be the same
as any network host names on your network. If the NetBackup client names are
changed or are not unique, backup and restore results are unpredictable.
For example, suppose you have 20 machines that share the IP addresses as
previously defined. If you want these machines to be NetBackup clients, you
might assign them these NetBackup client names as follows:
nbclient01
nbclient02
nbclient03
nbclient04
nbclient20
In our example, you can enter these commands to create the 20 clients:
cd /usr/openv/netbackup/bin/admincmd
Current Host:
Hostname: *NULL*
IP Address: 0.0.0.0
Current Host:
Hostname: *NULL*
IP Address: 0.0.0.0
Current Host:
Hostname: *NULL*
IP Address: 0.0.0.0
The NetBackup client notifies the NetBackup server of its NetBackup client
name and network host name. Then, the Current Host, Hostname, and IP
Address fields display the values for that NetBackup client.
Start the Backup, Archive, and Restore user interface on the client and then
select File > NetBackup Client Properties. The NetBackup Client Properties
dialog box appears. Select the General tab. Change the Client Name to specify
value specifies how many minutes the client waits before it announces that it
For more information, see “Announce DHCP interval” on page 455 in the
The server is not notified if the default value of 0 is used. For a DHCP client, a
On the client, stop and restart the NetBackup Client service to have the changes
take effect.
CLIENT_NAME = nbclient00
You must run the bpdynamicclient command once when the system first
starts up. bpdynamicclient notifies the NetBackup server of the machine's
104 Additional configuration
Dynamic host name and IP addressing
rm /usr/openv/netbackup/last_successful_hostname
/usr/openv/netbackup/bin/bpdynamicclient
-last_successful_hostname \
/usr/openv/netbackup/last_successful_hostname
EOF
Ensure that the dynamic client startup script is called after the machine obtains
its IP address.
You must also create a root crontab entry to call periodically the
bpdynamicclient command. For example, the following entry (one line) calls
7 * * * * /usr/openv/netbackup/bin/bpdynamicclient
-last_successful_hostname
/usr/openv/netbackup/last_successful_hostname
Note: Busy file processing applies only to UNIX clients. For information
concerning Microsoft Windows clients, see “VSP (Volume Snapshot Provider)
properties,” in the NetBackup Administrator’s Guide, Volume I.
A busy file is a file that was detected as changed during a user or a scheduled
backup. Typically, detection occurs if a process writes to a file while NetBackup
attempts to back it up. The following conditions result in the detection of busy
files:
■ Read error on the file
■ File modification time changed
■ File inode time changed
■ File size changed
The backup usually completes with a status of 1, that indicates that the backup
was partially successful. Busy file processing allows the user control the actions
of NetBackup when busy files are detected.
Busy file processing can be configured in the Busy File Settings host properties
for UNIX clients. For more information, see Chapter 7, “Host properties,” in the
NetBackup Administrator’s Guide, Volume I.
Busy file processing can also be enabled, by adding the
BUSY_FILE_PROCESSING option to the client
/usr/openv/netbackup/bp.conf file. Then, add other busy file options to
control the processing of busy files. The options can exist in both the client
/usr/openv/netbackup/bp.conf file and a user’s $HOME/bp.conf. The
user’s bp.conf file takes precedence when the options are in both places.
NetBackup creates several files and directories when processing busy files.
Initially, a working directory named busy_files is created under
/usr/openv/netbackup. NetBackup then creates the /actions directory
under busy_files and places action files in that directory. An action file
contains the information that NetBackup uses to control the processing of busy
files.
By default, the contents of the action file are derived from the
BUSY_FILE_ACTION options in bp.conf. A user can also create an action file
to control a specific backup policy and schedule. NetBackup creates a logs
directory under busy_files for storing busy file status and diagnostic
information.
For more information, see “Creating action files” on page 108.
106 Additional configuration
Getting started
To use the bp.conf file to configure busy file processing, perform the following
steps:
■ Modify the bp.conf file options as described in the following section,
“Modifying bp.conf to configure busy file processing” on page 106.
Copy the bpend_notify_busy script:
/usr/openv/netbackup/bin/goodies/bpend_notify_busy
to the path:
/usr/openv/netbackup/bin/bpend_notify
Be sure to set the file access permissions to allow group and other to execute
bpend_notify.
(This step is also performed when configuring busy file processing in the
■ 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 (upper-case 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.
(This step is also performed when configuring busy file processing in the
Or, configure busy file processing using the following entries in the bp.conf
file on the client. The user may also configure a bp.conf file in a home
directory. The busy file options specified in the user's bp.conf file apply only to
BUSY_FILE_PROCESSING
The BUSY_FILE_PROCESSING entry enables the NetBackup busy
file-processing feature. By default, this entry is not present in the client’s
/usr/openv/netbackup/bp.conf file.
Additional configuration 107
Busy file processing (UNIX clients only)
BUSY_FILE_DIRECTORY
The BUSY_FILE_DIRECTORY entry specifies an alternate path to the busy files
working directory. This entry is not required. By default, this entry is not
present in the client’s /usr/openv/netbackup/bp.conf or $HOME/bp.conf
file. By default, NetBackup creates the busy_files directory in
/usr/openv/netbackup or the user’s home directory.
BUSY_FILE_ACTION
The BUSY_FILE_ACTION entry directs the action that NetBackup performs on
busy files. By default, this entry is not present in the client’s
/usr/openv/netbackup/bp.conf or $HOME/bp.conf file.
Multiple entries may exist in the following form:
BUSY_FILE_ACTION = filename_template action_template
Where
■ filename_template is the absolute pathname and file name of the busy
file. The shell language metacharacters *, ?, [], [ - ] can be used to
match the patterns of file names or parts of file names.
■ action_template is one of the following:
MAIL | mail
Directs NetBackup to mail 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 busy file processing.
The file is backed up and a log entry that indicates that the file was
busy appears in the All Log Entries report.
BUSY_FILE_NOTIFY_USER
This option specifies the recipient of the busy file notification message
when BUSY_FILE_ACTION is set to MAIL or mail. By default,
BUSY_FILE_NOTIFY_USER is not in
/usr/openv/netbackup/bp.conf or $HOME/bp.conf file on a
client. By default, the mail recipient is root.
Example 1
BUSY_FILE_PROCESSING
BUSY_FILE_DIRECTORY = /tmp
BUSY_FILE_NOTIFY_USER = kwc
This set of options causes NetBackup to take the following actions when it
encounters busy files:
■ Create the busy files working directory in /tmp
■ Send an email notification message to user kwc for all busy files that it finds
under /usr except for those in /usr/local.
Example 2
BUSY_FILE_PROCESSING
This set of options causes NetBackup to take the following actions when it
encounters busy files:
■ Send a busy file notification message to root for busy files in /usr/openv.
■ Repeat the backup up to two times for all busy files that it finds under /usr,
except for those in /usr/openv and /usr/local.
■ Exclude the busy files in /usr/local from all actions.
actions.policy_name
2 If a file for a specific policy and schedule is not found, NetBackup searches
for a less specific name, such as the following:
Additional configuration 109
Busy file processing (UNIX clients only)
actions.policy_name
3 If a less specific name does not exist, NetBackup refers to the default action
file.
The contents of user-created action files are similar to the default. Optional
comment lines can be included. The specification is the same as for the
BUSY_FILE_ACTION option:
# comment_line
filename_template action_template
Example 1
The bp.conf file might contain the following:
BUSY_FILE_ACTION = /usr/openv mail
BUSY_FILE_ACTION = /usr/* repeat 2
BUSY_FILE_ACTION = /usr/local ignore
If yes, the default actions file (named actions) contains the following lines:
/usr/openv mail
/usr/* repeat 2
/usr/local ignore
Example 2
An action file name for a backup policy production_servers with a schedule name
full follows:
actions.production_servers.full
The actions file can contain the following line:
/bin/* repeat
If yes, NetBackup repeats the backup for busy files in the /bin directory.
Logs directory
During busy file processing NetBackup creates a number of files under the
busy_files/logs directory. These files contain status and diagnostic
information. NetBackup derives the names of these files from the policy name,
schedule name, and process id (PID) of the backup.
■ Busy file log
NetBackup records the names of any busy files in the busy file log. The
name of the busy file log has the following form:
policy_name.schedule_name.PID
Example
To service busy file backup requests, the administrator defined a policy named
AAA_busy_files that has a user backup schedule named user. A scheduled
backup is initiated with the policy named production_servers, schedule named
full, and PID of 1442.
If busy files are detected, NetBackup generates the following files in the
/usr/openv/netbackup/busy_files/logs directory:
production_servers.full.1442
log.production_servers.full.1442
If the actions file has the repeat count set to 2, NetBackup generates the
following files:
production_servers.full.1442.retry.0
AAA_busy_files.user.10639
log.AAA_busy_files.user.10639
AAA_busy_files.user.15639
log.AAA_busy_files.user.15639
Modifying bpend_notify_busy
The administrator can modify busy file processing by changing the
bpend_notify_busy script. The only recommended changes are as follows:
■ Changing the RETRY_POLICY and RETRY_SCHED variables from NONE to
the busy file backup policy name and schedule name.
■ Remove the files in the logs directory after busy file processing (these logs
are not removed automatically):
a At the end of the busy_files() function, add the following command:
/bin/rm -f $LOG_FILE
b After the call to the busy_files() function in main, add the following
commands:
/bin/rm -f $BUSYFILELOG
/bin/rm -f $RETRY_FILE
For more information, see “Goodies scripts” on page 687 in the NetBackup
Platform Directions
Windows To access the regional settings, double-click Regional and Language Options in the Windows
Control Panel. The Regional and Language Options dialog box provides access to the predefined
number, date, and time formats.
See the Microsoft Help pages for further assistance.
UNIX The /usr/openv/msg/.conf file contains information on the supported locales. This file
defines the date and the time formats for each supported locale.
The .conf file contains very specific instructions on how to add or modify the list of supported
locales and formats. However, the format of the file is summarized here.
The .conf file is divided into two parts, the TL lines and the TM lines.
TL Lines
The third field of the TL lines defines the case-sensitive locales that the NetBackup applications
support. The fourth and the fifth fields define the date and the time fields and associated
separators for that supported locale is as follows:
You can modify the existing formats to change the default output. For example, the TL line for the
C locale is:
TL 1 C :hh:mn:ss/mm/dd /yyyy
An alternate specification to the order of months, days, and years would be as follows:
TL 1 C :hh:mn:ss -yyyy-mm-dd
or:
TL 1 C :hh:mn:ss/dd /mm/yy
You can add more TL lines; see the comments in the .conf file.
If the .conf file is not accessible, the default locales (TL lines) are:
TL 2 ov :hh:mn:ss/mm/dd /yyyy
Platform Directions
TM Lines
The TM lines define a mapping from unrecognized locales to those supported by NetBackup, as
defined by the TL lines.
The third field of the TM lines defines the unrecognized locale. The fifth field defines the
supported equivalent that is identified in the TL lines.
For example, use the following TM line to map the unrecognized locale french to the supported
locale fr, the TM line is:
TM 6 french 2 fr
To map french to C
TM 6 french 1 C
To add more TM lines, see the specific instructions in the .conf file.
If the .conf file is not accessible, no default TM lines exist, as the default locale is C (ov).
zone server. Doing so changes the time zone for the Central time zone
server as well.
Select Absolute date to have DST begin on a To have DST begin on April 5:
specific date.
Select First day of week in month to have To begin DST on the first Monday in April:
a month.
Select First day of week in month after date To begin DST on the first Monday after April 5:
and day.
Select Last day of week in month to have DST To begin DST on the last Thursday in April:
month.
Select Last day of week in month after date To begin DST before April 30:
and day.
g Indicate when DST should end, using one of the methods in step e.
h To have administrative capabilities and apply the settings to the current
session and all future sessions, select Save as default time zone.
4 Click OK.
116 Additional configuration
Adjusting time zones in the NetBackup-Java console
Chapter 2
Menu user interfaces
The following menu user interfaces are available on UNIX or Linux systems to
manage NetBackup:
■ “Using the bpadm NetBackup management utility” on page 118
The terminology, general concepts, and results are the same regardless of the
Note: Use bpadm only on the master server. Make sure that no other instances of
bpadm or the NetBackup Administration Console are active while the
configuration is modified. To modify the configuration by using multiple
utilities may produce unpredictable results.
Start the bpadm program by running the bpadm command as a root user. bpadm
is located in the following directory:
/usr/openv/netbackup/bin
NetBackup Administration
-------------------------
d) Data Classification Management...
s) Storage ...
p) Policy Management...
g) Global Configuration...
r) Reports...
m) Manual Backups...
x) Special Actions...
u) User Backup/Restore...
e) Media Management...
h) Help
q) Quit
ENTER CHOICE:
All menus provide online help. For more information, the topics are discussed in
the corresponding chapter of the NetBackup Administrator’s Guide, Volume I.
Press the escape (Esc) key to abort most operations.
Description: <ALL>
Rank: <ALL>
Data Classifications
-------------------------
a) Add Data Classification ...
e) Enter
h) Help
q) Quit
Storage
-------
u) Storage Unit Management ...
h) Help
q) Quit Menu
-----------------------------
a) Add Storage Unit Group...
ENTER CHOICE:
Policy: <none>
Clients: <none>
Schedules: <none>
Policy Management
-----------------
a) Add Policy...
d) Delete Policy
s) Schedule Management...
e) Enter Policy
l) List/Display Policies
h) Help
q) Quit Menu
ENTER CHOICE:
online catalog backup as you would create a policy, from the Policy
Management menu.
5 Select policy attribute 1) Policy Type, then enter policy type selection
21) NBU-Catalog.
6 The NBU-Catalog policy type presents the following policy configuration
options:
Modify Policy Attributes (<ESC> to quit)
-----------------------------------------
1) Policy Type/subtype : NBU-Catalog
2) Active : Yes
detection
16) Keyword :
9 To create a schedule for the policy, from the Policy Management menu,
press s (Schedule Management).
10 From the Schedule Management menu, press a (Add Schedule).
11 Type a label for the schedule and press Return.
12 NBU-Catalog policy types allow the following schedule types:
Add Schedule (<ESC> to abort)
-----------------------------
Enter Schedule Label: full_sched
Schedule Type
-------------
0) Full Backup
See the NetBackup Administrator’s Guide, Volume I for the details of adding
a schedule to a policy.
13 Disaster recovery information should be configured for NBU-Catalog
policies.
From the Policy Management menu, press t (Catalog Backup
Disaster Recovery). Disaster recovery information can only be
configured for NBU-Catalog policies:
Policy: catalog-backup
-------------------------------------------------------
1) Disaster Recovery Email Address :
2) Disaster Recovery File Location :
3) User Name to Access File Location :
4) Password to Access File Location :
5) Critical policy :
The Modify Catalog Backup Disaster Recovery menu contains the following
options:
1) Disaster Recovery Email Address
Enter the path to the directory where the disaster recovery information is
to be saved. Specify an NFS share.
Note: Symantec recommends that the image file is saved to a network share
or a removeable device. Do not save the disaster recovery information to the
local machine.
If necessary, enter the logon name used to access the NFS share.
4) Password to Access File Location
Global Configuration
--------------------
m) Modify Configuration Parameters...
h) Help
q) Quit Menu
-----------------------------
h) Help
q) Quit
ENTER CHOICE:
Alternatively, you can start the Fibre Channel Transport Management utility by
using the /usr/openv/netbackup/bin/nbftadm command.
Displaying reports
Use the Reports menu to view problem or status reports from one or more
NetBackup servers or clients. To use the Reports menu, press r (Reports) on
the bpadm main menu.
Server: ALL
Client: ALL
Reports
-------
b) Backup Status
p) Problems
m) Media ...
d) Change Dates
c) Change Client
s) Change Server
o) Output Destination (SCREEN or FILE)
h) Help
q) Quit Menu
ENTER CHOICE:
Policy: W2
Client: <ALL>
Manual Backups
--------------
i) Initiate Backup
s) Browse Schedules
e) Enter Policy/Client/Schedule...
h) Help
q) Quit Menu
ENTER CHOICE:
Special Actions
---------------
c) Install All Clients...
h) Help
q) Quit Menu
----------------------
m) Modify Offline Catalog Backup Settings...
Note: An offline, cold catalog backup, exists by default and does not need to be
created. However, in order for the offline catalog backup to run, it must be
configured to run (the default is Never). Use option m from the Offline
Catalog Backup menu.
An online, hot catalog backup is created using the Policy Management menu.
For a description of the process, see “Configuring an online catalog backup” on
page 120.
For example, assume you change to a different media ID to make an extra copy
of the catalog files. When you change to the new media ID, NetBackup replaces
the old ID with the new ID. It no longer tracks the old ID in its database. This
results in the media being associated with old ID being made available for
reassignment by Media Manager.
Modify ID 1? (y/n): y
1) Disk
2) Media Manager
Modify ID 2? (y/n): y
1) Disk
2) Media Manager
Density Selections
Caution: An offline catalog backup does not span tape volumes. All the backup
data must fit on one tape. Therefore, it is extremely important for the
administrator to select a media type that can contain all the data to be backed
up. The size requirement is dependent on the size of the databases. NetBackup
sends a notification if the backup fails.
130 Menu user interfaces
Using the bpadm NetBackup management utility
4 Select the storage unit type (the number in parentheses shows the current
type).
■ Press 1 for Disk type and specify the path where the offline catalog
backup is to be written. This should be to a subdirectory. NetBackup
creates the path if it does not exist and produces an error if the path
exists and is a file rather than a directory.
Note: If the path already exists, the error NetBackup reports occurs when the
backup is performed, not when the path is specified.
■ Press 2 for a Removable or Robotic type storage unit and select the
density.
Specify the media ID (volume serial number) of the media to use.
5 Specify whether to modify the second media ID (ID 2). If y, you are
prompted as shown for media ID 1 in step 3.
6 Specify whether to make the changes. Either choice returns you to the
Offline Catalog Backup menu.
7 To back up the offline catalog to a media server (see step 2), modify the
offline catalog backup paths for the master server:
a Remove each backup path for the master server by using the Remove
Offline Catalog Backup File Path option on the Offline
Catalog Backup menu.
b To add each backup path for the master server again, press a (Add
Offline Catalog Backup File Path) while viewing the Offline
Catalog Backup menu.
When the paths are added, specify the paths in the following format:
master_name:database_backup_path
For example, if the platform is named bunny, the paths are as follows:
bunny:/usr/openv/netbackup/db
bunny:/usr/openv/volmgr/database
Note: If the media ID used for the offline catalog backup is not in a robot, a
mount request for that media ID is sent. If the mount request is not honored, a
manual offline catalog backup must wait for the mount before proceeding. A
schedule-driven catalog backup must also wait for the mount and, because the
schedule is waiting, all other backups and archives must also wait until the
catalog backup is complete.
■ Press y to start the offline catalog backup. NetBackup uses the least recently
used of the two media IDs you have assigned for backups. You must wait for
completion of the backup to regain control of the terminal session.
■ Press n to abort the operation.
* 2 3 weeks * 3 1 month
4 2 months 5 3 months
6 6 months 7 9 months
* 8 1 year * 9 infinity
10 infinity 11 infinity
12 infinity 13 infinity
14 infinity 15 infinity
16 infinity 17 infinity
18 infinity 19 infinity
20 infinity 21 infinity
22 infinity 23 infinity
24 infinity
q=quit, s=save)>
Note: An asterisk in front of a retention level indicates that the retention level is
referenced in a currently defined schedule. To change the retention level may
have adverse effects on the schedules that use it.
132 Menu user interfaces
Using the vmadm media management utility
-----------------------------
ENTER CHOICE:
Starting vmadm
You must be the root user to run vmadm.
To start vmadm
◆ Enter /usr/openv/volmgr/bin/vmadm.
Menu user interfaces 133
Using the vmadm media management utility
2 Choose t for Terminate Media Manager Volume Daemon. This stops vmd
and returns you to the Special Actions menu.
Media Management
-----------------
a) Add Volumes
d) Delete Volumes
m) Move Volumes
s) Special Actions
h) Help
q) Quit
ENTER CHOICE:
Specify an option by pressing the key that corresponds to the menu option. Each
The Database Host is the host on which the EMM database resides and the Media
---------------------
a) Add Pool
c) Change Pool
d) Delete Pool
l) List Pools
h) Help
q) Quit Menu
ENTER CHOICE:
To add, change, or delete volume pools, press the letter key that corresponds to
For more information about volume pools, see “Volume pool operations” in the
“Media” chapter of the NetBackup Administrator’s Guide for UNIX and Linux,
Volume I.
Adding volumes
To add volumes, press a at the Media Management menu and then follow the
prompts. You can add:
■ stand-alone volumes (when prompted for the location, specify Not in
robotic device)
■ Volumes to a robot (when prompted for the location, specify the robot in
which the volumes reside)
You can add a single volume, a range of volumes, or let vmadm read the barcodes
on the media and add them automatically (auto-populate).
For more information about volumes, see “Volume operations” in the “Media”
chapter of the NetBackup Administrator’s Guide for UNIX and Linux, Volume I.
Menu user interfaces 135
Using the vmadm media management utility
Auto-populating a robot
You can use auto-populate for the robots that support barcodes and for the
robots that do not support barcodes, with some operational limitations. For
limitations, see “Robot attributes” in the NetBackup Device Configuration Guide.
The easiest way to add new media to NetBackup is to:
■ Inject the media into the robot.
■ Use auto-populate to update the EMM database to agree with the contents of
the robot. The database update includes automatic creation of media IDs.
If the robot supports barcodes and the volumes have readable barcode labels,
auto-populate generates media IDs for new volumes from one of the following:
■ The last six characters of the barcodes.
■ Media ID generation rules.
When you use barcode rules, the new media that are added through a barcode
rule are assigned: a media type, a pool name, a maximum number of mounts (or
cleaning), and a description.
If the robot does not support barcodes or the media does not have readable
barcodes, the new media IDs are based on a media ID prefix that you specify.
Auto-populate prerequisites
The following are prerequisites for auto-populating a robot:
■ Check the barcode capabilities of the robot and its media by following the
procedures in “Inventory robots” on page 140. Check whether the following
are true:
■ The robot supports barcodes.
■ The new media have readable barcodes.
If the robotic library does not support barcodes or the media do not have
readable barcodes, save the results of the verify. You can use those results if
You can use the physical inventory utility for nonbarcoded media. For
Volume I.
■ For API robots, create media type mappings for the robot as explained in
“Changing update options” on page 141
You can change the default media type mappings as explained in “Managing
Media” in the NetBackup Administrator’s Guide for UNIX and Linux, Volume
I.
■ Ensure that the appropriate control daemons are active on the robot control
host.
file.
Press p at the Media Management menu to display the Display Options menu.
To show all volumes in the configuration, press s at the Display Options menu.
You can toggle between brief or full display. You can send the output to the
screen (the default) or write it to a file. You can filter the output by the following
criteria:
■ All
■ Media ID
■ Media type
■ Volume group
■ Robot number
■ Robot type
■ Volume pool
■ Vault container ID
If you delete multiple volumes, you enter the media IDs one at a time. When you
have deleted all of the volumes, press Enter without entering a media ID.
If the robot supports barcodes and the media have readable barcodes, the easiest
method to move volumes is to inventory the robot and update the volume
configuration.
If the robot does not support barcodes or the barcodes are unreadable, use one of
the following:
■ The move procedures in the following subsection.
■ The physical inventory utility (see “Using the physical inventory utility” in
the “Media” chapter of the NetBackup Administrator’s Guide for UNIX and
Linux, Volume I).
For an overview of how to move volumes, see “Moving volumes” in the
NetBackup Administrator’s Guide for UNIX and Linux, Volume I.
At the Volume Pool menu, select the new volume pool for the volume, and then
To quit changing volumes, press Enter at the Enter Media ID prompt without
entering a media ID. To change another volume, enter another media ID.
expiration date is the age of the media, not the age of the data on the media. It is
When the expiration date of a volume has passed, NetBackup can still read it.
However, NetBackup does not mount an expired volume for a write access.
NetBackup writes a warning message to the system console log for a read access
Press s at the Media Management menu, press e at the Special Actions menu,
Enter 0 for no expiration date or enter a date in one of the following formats:
■ mm/dd/yy hh/mm/ss
■ mm/dd/yyyy hh/mm/ss
■ mm/dd/yy
■ mm/dd/yyyy
■ mm/dd
To quit changing volumes, press Enter at the Enter Media ID prompt without
entering a media ID. To change another volume, enter another media ID.
You can change one or more volumes. To quit changing volumes, press Enter at
the Enter Media ID prompt without entering a media ID. To change another
At the Volume Group menu, select the new group for the volumes or generate a
Press s at the Media Management menu and then press a at the Special Actions
-----------------------
n) Change Vault Name for Volumes
h) Help
q) Quit Menu
ENTER CHOICE:
Press the letter key that corresponds to the attributed you want to change.
You can change one or more volumes. To quit changing volumes, press Enter at
the Enter Media ID prompt without entering a media ID. To change another
Note: You cannot set the maximum number of mounts for a cleaning cartridge.
Press s at the Media Management menu, press s at the Special Actions menu,
You can change one or more volumes. To quit changing volumes, press Enter at
the Enter Media ID prompt without entering a media ID. To change another
Note: You cannot use the Update/Validate Barcodes option for API robots
because NetBackup does not manage media location information for API robots.
Press s at the Media Management menu, press u at the Special Actions menu,
You can update one or more volumes. To quit updating volumes, press Enter at
the Enter Media ID prompt without entering a media ID. To update another
Inventory robots
For the robots that support barcodes and have media with readable barcodes,
you can inventory the media in the robot. You also can use one of the inventory
options to add new media to the NetBackup configuration.
Inventory a robot
Select the inventory type from the Special Actions menu and follow the
prompts. The procedure is similar for each type of inventory.
Special considerations
■ ACS and TLM robots: at the Robot Control Host prompt, enter the host on
which the NetBackup robotic daemon runs (acsd or tlmd).
■ For an inventory and compare operation:
■ For API robots, NetBackup determines whether the media ID and media
type that is stored in the EMM database matches the robot’s database.
■ For non-API robots with barcode readers, NetBackup determines
whether the barcodes in the robot match those in the EMM database.
When the report shows <none>, it means that the media does not have
a barcode.
■ For the robots that cannot read barcodes, vmadm verifies only whether
the EMM database correctly shows whether a slot contains media.
Menu user interfaces 141
Using the vmadm media management utility
-----------------------
-------------------------------
Update Options
-------------
h) Help
q) Quit Menu
ENTER CHOICE:
To change an update option, select the letter key that corresponds to the option.
For most configurations, the default update options work well. You should only
requirements.
■ Use barcode rules. If yes, NetBackup attempts to use barcode rules only for
the volumes that are not already in the EMM database.
■ Media type if you do not use barcode rules. For API robots vmadm uses the
Media Type Mappings that are displayed. For non-API robots that are
142 Menu user interfaces
Using the vmadm media management utility
configured on this robot host, vmadm uses the media type for the robot as
follows:
■ If all of the drives are the same type and at least one drive is configured
on the robot control host, vmadm uses the media type for the drives.
■ If all of the drives are not the same type, vmadm uses the default media
type for the robotic library.
■ The robotic library supports multiple media types and you do not want
the default media type.
■ The drives are not configured on the robot control host and the drives
are not the default media type for the robot.
■ Media type if you use barcode rules, choose DEFAULT to let the barcode rule
determine the media type that is assigned. To use a media type other than
the default, choose a specific type from the menu. The update media type
setting always overrides barcode rules.
■ Media ID prefix. Specify a media ID prefix if the robot does not support
barcodes and the media that was inserted does not have readable barcodes.
If neither of the previous conditions are true, a prefix is not required.
NetBackup uses one of the following for a Media ID:
■ The last six characters of the barcode.
■ The characters that you specify if you use Media ID generation rules,
whether or not a barcode rule is used.
If you select default media ID prefix, vmadm uses the last
MEDIA_ID_PREFIX entry in the vm.conf file. If no MEDIA_ID_PREFIX
entries exist, vmadm uses the letter A as the default prefix.
If you select use no media ID prefix, the operation succeeds only if the robot
supports barcodes and the media have readable barcodes. This choice may
be useful if you use media with barcodes and want updates to fail when
unreadable or missing barcodes are encountered.
■ Volume Group for removed media. If Media Type is DEFAULT, you can
choose from the existing volume groups that are valid for the robot’s default
Media Type. If Media Type is other than DEFAULT, you can choose from the
existing volume groups that are valid for the media type.
■ Volume group for added or moved media. If Media Type is DEFAULT, you can
choose from the existing volume groups that are valid for the robot’s default
Media Type. If Media Type is other than DEFAULT, you can choose from the
existing volume groups that are valid for the media type.
■ Use platter side in media ID. For ODL robots, choose yes to include an A/B
designation in the media IDs for the two sides of an optical disk platter. One
Menu user interfaces 143
Using the vmadm media management utility
side has a media ID of xxxxxA and the other side xxxxxB, where xxxxx is the
media ID prefix and and number. If no, a platter side designation is not
used. The two sides of an optical disk platter are referred to as media ID
partners.
Use platter side in media ID appears only if you inventory and update on an
ODL robot and you use a media ID prefix.
■ Volume pool. If you use barcode rules, by default the volume pool setting of
the barcode rule determines the volume pool that NetBackup assigns. The
Update Options volume pool always overrides a barcode rule. If you do not
using barcode rules, by default NetBackup uses: the NetBackup volume pool
for data volumes and the None volume pool for cleaning tapes.
----------------------
a) Add Rule
c) Change Rule
d) Delete Rule
l) List Rules
h) Help
q) Quit Menu
ENTER CHOICE:
For more information about barcode rules, see “Barcode Rules tab” in the
“Media” chapter of the NetBackup Administrator’s Guide, Volume I.
When you use vmadm, the media ID becomes the recorded media ID. The
following steps use vmadm. See tpformat in NetBackup Commands for UNIX
and Linux for a description of how to use tpformat.
Note: All operating systems do not support 1024 byte-per-sector platters. Most
support only 512 byte-per-sector sizes. Before you purchase optical disk
platters, check your operating system documentation to determine which sector
sizes it supports. Also see the Symantec support web site for information on
what is supported. Symantec recommends that you use preformatted platters.
Robot number
You assign a robot number when you add a robot to the configuration.
tpconfig prompts you to enter a number or accept the next available robot
number that it displays. This number identifies the robot in displays and
listings, and it follows the robotic type in parentheses, such as TL8(2).
The following point applies only to NetBackup Enterprise Server.
If you configure robots on multiple systems, robot numbers must be unique. If
you connect drives from a robot to multiple systems, you must specify the same
robot number for the robot on all systems.
may be on another host. If so, enter the host name of the host instead of a path.
When you define a robot that another host controlls by another host, the robot
number must be the same on both hosts.
Host name
This topic is a NetBackup Enterprise Server topic.
You must specify a host name in the following cases. When you add:
■ An ACS robot, enter the name of the host on which the ACS Library Software
resides instead of a robotic control path.
■ A TLM robot, enter the DAS or Scalar DLC server name instead of a robotic
control path.
■ An TL8, TLD, or TLH robot that has robotic control on another host, you are
prompted for the host name of that host.
The volume header device name is used internally but must be specified when
you add an optical drive to a configuration. For the device path, enter the path
name to the device as found in the /dev directory. To display the volume header
device name, choose the Update or Delete option from the Drive Configuration
menu.
On Solaris SPARC systems, the MAKEDEV command may have to be run first to
create these entries. For more information, see the NetBackup Device
Configuration Guide and the MAKEDEV(8) command.
Drive status
Drive status indicates whether NetBackup considers a drive available. You
specify the initial drive status when you add a drive to the configuration. You
can change the status. To do so, use the Update option of the Drive
Configuration menu in tpconfig (ensure that ltid is not active). If ltid is
active, use the Administration Console Device Monitor or the vmoprcmd
command.
1) Drive Configuration
2) Robot Configuration
3) Credentials Configuration
4) Print Configuration
5) Help
6) Quit
Enter option:
Note: If the Media Manager device daemon is running, you should stop it with
the stopltid command.
Menu user interfaces 147
Using the tpconfig device configuration utility
3 C
redentials Opens a menu to add, delete, update, or list credentials
Configuration for:
■ NDMP filer
■ Disk array
■ OpenStorage server
■ Virtual machine
You can return to the main menu from anywhere in the utility by entering Ctrl C
or using the Escape key.
Adding robots
When you configure robots and drives, first add the robots using the Robot
Configuration menu and then add the drives using the Drive Configuration
menu.
To change stand-alone drives to robotic, use the Update option of the Drive
Configuration menu. See “Updating a drive configuration” on page 150.
148 Menu user interfaces
To add a robot
3 From the list of possible robot types, select the one you want to add.
4 Enter a robot number you know is unused or accept the default robot
number.
5 Indicate where the robotic control for the library is by entering the device
file path or library name. The Help option on the Robot Configuration menu
has examples of typical path names.
6 This step applies only to NetBackup Enterprise Server.
a If robotic control is on another host, enter that host name.
For an ACS robot, you must enter the name of the ACS library software
host.
For a TLM robot, you must enter the name of the DAS or Scalar DLC
server.
b If robotic control is on this host, enter the device file path or library
name. The Help option on the Robot Configuration menu has examples
of typical path names.
For an ACS robot, enter the name of the ACS library software host.
For a TLH robot on an AIX system, enter the LMCP Device File;
otherwise, enter the Automated Tape Library Name.
For a TLM robot, enter the name of the DAS or Scalar DLC server.
7 If no conflicts are detected with the new configuration, you see a message
that the robot was added.
Adding drives
Use the following procedure to add a drive.
To add a drive
3 From the list of possible drive types that are displayed, select the one you
want to add.
4 Enter the no rewind on close device path as shown in the /dev directory.
If the device is an optical disk, enter the character device and volume
header device file paths. File paths are in the /dev directory (volume
headers do not appy to all systems).
Menu user interfaces 149
Using the tpconfig device configuration utility
The Help option on the Drive Configuration menu has examples of typical
path names.
5 Enter the drive status (Up or Down).
6 If a robot exists to which the you can add the drive, specify whether to add
the drive to the robot. Alternatively, you can configure the drives as a
stand-alone drive.
If there are no robots to which you can add the drive, tpconfig
automatically adds the drive as a stand-alone drive.
If you add a drive to a robot and more than one possible robot exists, enter
the number of the robot that controls the drive.
Depending on the type of robot, you may also be prompted to add the robot
drive number.
7 This step applies only to NetBackup Enterprise Server.
For a drive in an ACS robot, you are prompted for four drive identifiers. For
more information on ACS robots, see the NetBackup Device Configuration
Guide.
For a drive in a TLH robot, you are prompted for an IBM device number. For
more information, see the appendix NetBackup Device Configuration Guide.
For a drive in a TLM robot, you are prompted for a DAS or Scalar DLC drive
name. For more information see the NetBackup Device Configuration Guide.
8 Type a drive name or press Enter key to use the default drive name.
The following point applies only to NetBackup Enterprise Server.
If you use the shared drives option, all hosts that share the same physical
drive must use the same name for the drive. Descriptive drive names are
recommended.
Note: If only one robot is configured, step 2 and step 3 are skipped.
4 Enter a new robot number to replace the existing robot number or press
Enter to retain the current robot number.
You are prompted to enter robotic control information. The actual prompts
depend on the type of robotic library you update.
5 Enter the appropriate robotic control path or name of the server that hosts
the robot.
Deleting a drive
Use the following procedure to delete a drive.
To delete a drive
If you respond with y, a message confirms that the drive was deleted.
If you respond with n, press any key to return to the Drive Configuration
menu.
Deleting a robot
Use the following procedure to delete a robot.
To delete a robot
Note: If only one robot is configured, step 2 and step 3 are skipped.
drives
2 On the credentials menu, select the type of credential you want to configure.
1) (N)dmp Filer
3) (O)penStorage Server
4) (V)irtual Machine
3 Select an option at the specific credentials menu and follow the prompts.
------------------------------------
h) Help
q) Quit Menu
ENTER CHOICE:
Managing SharedDisk
Use the Enclosure Management for SharedDisk menu to configure and manage
To display this menu, press e (Enclosure Management for SharedDisk) from the
-----------------------------------
p) Preview Enclosure
i) Import Enclosure
h) Help
q) Quit Menu
ENTER CHOICE:
To configure and manage AdvancedDisk, select a menu option and follow the
prompts.
Managing OpenStorage
Use the OpenStorage Disk Management menu to configure and manage disk
---------------------------
h) Help
q) Quit Menu
ENTER CHOICE:
To configure and manage OpenStorage, select a menu option and follow the
prompts.
156 Menu user interfaces
Using the disk configuration utility
Chapter 3
Reference topics
The topics in this chapter provide additional information about various aspects
of NetBackup configuration and management:
■ “Rules for using host names in NetBackup” on page 158
environment contains multiple domains, qualify host names to the extent that
specified on the client.) The client name that is used is usually the
CLIENT_NAME from the bp.conf file of the client. Or, the client name may be
the actual host name of the client if not in the bp.conf file. Alternate client
restores may use the name that is specified through the user interface or with a
parameter on the bprestore command.
For a successful request, the client name must match the name that is specified
for the client in the NetBackup configuration on the server. The only exception
to this rule is if the server is configured to allow alternate client restores.
Policy configuration
The configured name for a client is the host name as it is added to a policy. This
name is how the client is identified in the NetBackup configuration. NetBackup
also adds a CLIENT_NAME entry to a UNIX client’s bp.conf file when software
is first installed on the client.
The server uses the client’s configured name to connect to the client and start
the processes that satisfy client requests. Always use qualified host names to
add clients to a policy so that all NetBackup servers can connect to the clients.
When a client makes a user backup, archive, or restore request to the NetBackup
server, the server uses the peer name of the client. The peer name (identified
from its TCP connection) is used to determine the client’s configured name.
If you add a client to more than one policy, always use the same name in all
cases. If the same name is not used, the client cannot view all the files that are
backed up on its behalf. In this case, file restores become complicated because
both user- and administrator-action is required to restore from some of the
backups.
Image catalog
A subdirectory in the image catalog is created for a client when a backup is first
created for that client. The subdirectory’s name is the client’s configured name.
Every backup for a client has a separate file in this subdirectory. Each of these
backup records contains the host name of the server on which the backup was
written.
160 Reference topics
Rules for using host names in NetBackup
Error catalog
NetBackup uses entries in the error catalog for generating reports. These entries
contain the host name of the server that generates the entry and the client’s
configured name, if applicable. The server host name is normally the server’s
short host name. (For example, shark instead of shark.null.com.)
Note: Do not change the host name of a NetBackup server. A name change might
require that all previously used media be imported to the server before the host
can be used under the new name.
Use the following steps to update the NetBackup configuration if a client’s host
name is changed.
1 On the master server:
■ Delete the client’s old name from all policies where it exists and add the
client’s new name to those policies. You do not need to reinstall
NetBackup software on the client. The client continues to have access
to all previous backups.
■ Create a symbolic link from the client’s old image directory to its new
image directory. For example,
cd /usr/openv/netbackup/db/images ln -s
old_client_name new_client_name
2 On the client:
■ On PC clients, change the client name setting either through the user
interface or in a configuration file. (See the online help in the Backup,
Archive, and Restore client interface.)
■ On UNIX clients, change the CLIENT_NAME value in the bp.conf file
to the new name.
Note: If users on UNIX clients have a bp.conf file in the $HOME directory, users
must change CLIENT_NAME in that file to the new name.
Reference topics 161
Rules for using host names in NetBackup
Where
■ key is a numeric value used by NetBackup to specify the cases where
translation is to be done. Currently this value must always be 0, which
indicates a configured name translation.
■ hostname_from_client is the value to translate. The client name must
correspond to the name that is obtained by running the client’s
gethostname(2). The value must be sent to the server in the request.
■ client_as_known_by_server is the name to substitute for
hostname_from_client for request responses. The name must match the
name in the NetBackup configuration on the master server and must also be
known to the master server’s network services.
Consider the following example:
0 xxxx xxxx.eng.aaa.com
The line specifies that when the master server receives a request for a
configured client name (numeric key 0), the name xxxx.eng.aaa.com always
replaces xxxx. The substitution resolves the problem if the following conditions
are true:
■ When gethostname(2) is run on the client, it returns xxxx.
■ The master server’s network services gethostbyname(2) library function
did not recognize the name xxxx.
■ The client was configured and named in the NetBackup configuration as
xxxx.eng.aaa.com. And, this name is also known to network services on
the master server.
162 Reference topics
Reading backup images with tar
Note: You cannot use the NetBackup modified-GNU tar on UNIX or tar32.exe
on Windows to extract files from a NetBackup for Windows backup image.
backup from a NetBackup tape. Most versions of tar can read the tapes that
NetBackup creates after using the mt command to position to the proper tape
location. First, see the notes following the procedure as well as “Effects of a
This sequence assumes that the media is known to Media Manager and that the
2 mt -f /tmp/tape rew
3 mt -f /tmp/tape fsf file_#
Where:
file_# is the tape file number of the backup on tape. Determine the tape file
number by checking the NetBackup Images on Media report for the tape.
4 mt -f /tmp/tape fsr
5 /bin/tar -tvfb /tmp/tape blocksize
Where:
■ blocksize is 64 (assume that the tape is written with 32K blocks)
164 Reference topics
6 tpunmount /tmp/tape
Where the e at the beginning of line one indicates that the backup is
encrypted. (Additional messages appear during recovery.)
3 This procedure does not work on the Solaris platform. You cannot use
/usr/sbin/tar on Solaris to read NetBackup backups. The Solaris tar
command uses the ctime and the atime fields differently than other tar
commands.
When /usr/sbin/tar is used to restore backups, directories with large
numbers are created at the top level. These directories are from the ctime
and the atime fields being read as pathnames.
You can, however, use /usr/openv/netbackup/bin/tar or GNU tar to
read the backups on Solaris platforms.
4 Steps 1 and 6 are optional in a stand-alone environment. If step 1 is skipped,
DOWN the drive, then substitute the /dev path of the drive in place of
/tmp/tape in the other steps. Remember to UP the drive when you are
done.
Example
The following example was successful on an HP9000-800 with a DOWNed
4mm stand-alone drive and the NetBackup tar.
mt -t /dev/rmt/0hncb rew
mt -t /dev/rmt/0hncb fsf 1
mt -t /dev/rmt/0hncb fsr 1
Some platforms require other options on the tar command. The following
is required on Solaris 2.4:
/usr/openv/netbackup/bin/tar -t -v -f /dev/rmt/0hncb -b 64
Total data
The total amount of data to back up depends on the size of the files for each
client included the policy. The total amount of data also depends on whether the
backup is a full backup or an incremental backup.
■ Full backups involve all the data. Therefore, a full backup usually takes
longer than an incremental backup.
■ Differential incremental backups include only the data that has changed
since the last full or incremental backup.
■ Cumulative incremental backups include all the data that has changed since
the last full backup.
For incremental backups, the amount of data depends on the frequency with
which files change. If a large number of files change frequently, incremental
backups are larger.
Transfer rate
The transfer rate depends on the following factors:
■ The speed of the backup device. Backups that are sent to tapes with a
transfer rate of 800 kilobytes per second are generally faster than tapes with
a transfer rate of 400 kilobytes. (Assume that other factors allow for the
faster transfer rate.)
■ The available network bandwidth. The available bandwidth is less than the
theoretical network bandwidth and depends on how much other network
traffic is present. For example, multiple backups occurring on the same
network compete for bandwidth.
■ The speed with which the client can process the data. The speed varies with
the hardware platform and depends on the other applications that run on
the platform. File size is also an important factor. Clients can process larger
files faster than smaller ones. A backup for twenty files, 1 megabyte each, is
faster than a backup for 20,000 files that are 1 kilobyte each.
■ The speed with which the server can process the data. Like client speed,
server speed also varies with the hardware platform and depends on the
other applications that run on the platform. The number of concurrent
backups being performed also affects server speed.
■ Network configuration can affect performance. For example, when some
machines run full-duplex and some run half-duplex in an Ethernet
environment, the throughput is significantly reduced.
For more information, see “Determining NetBackup transfer rate” on page 167.
Reference topics 167
Determining NetBackup transfer rate
Compression
Software compression often multiplies the backup time by a factor of two or
three for a given set of data.
Device delays
Device delays can be due to the following factors: the device may be busy or slow
to load the media. Or, the device may be slow to find the location on the media at
which to start writing the backup. These delays can vary widely and depend on
the devices and the computing environments.
To calculate the transfer rate, divide this time (in seconds) into the total bytes
that are transferred. (The total bytes that are transferred is recorded in the All
Log Entries report.)
168 Reference topics
Determining NetBackup transfer rate
Examples
Assume that the reports provide the following data.
Sample All Log Entries Report:
TIME SERVER/CLIENT TEXT
id giskard_0767592458, fragment 1 to
backup id giskard_0767592458,
230.325 Kbytes/sec
The following topics explain how NetBackup determines the order in which
automatic backups occur for each client. This information is useful to evaluate
problems with schedules.
considered Queued, and appears on the Jobs tab of the Activity Monitor.
Once a job receives the resources it needs, the job becomes Active and begins.
When the job completes, NetBackup computes the next due time for the job, thus
The order of the jobs on the worklist is dynamic. The following items are some of
■ Whether the job finished successfully or whether it failed and is Waiting for
Retry.
(The time that NetBackup waits before it tries the job again is configurable
by setting the Job retry delay Global Attribute master server property.
A retried job retains the original job ID. If the job does not succeed after the
number of attempts that are allowed, the job is considered Done. The status
of the job indicates that the job was not successful. The number of attempts
counts toward the Schedule backup attempts limit. (Found under Host
Properties > Global Attributes > Schedule backup attempts.)
■ Whether attempts to run the job exceed the number of attempts that the
Schedule backup attempts host property indicates.
170 Reference topics
■ Whether the job is a child job. When a parent job is Active, all of the children
from that parent job have precedence over other jobs. The precedence
includes the children of another parent job.
Both clients are overdue for a backup. However, the job of client client_2 is
the most overdue and runs first.
This approach ensures that a backup that was unsuccessful during its
previous backup window has priority over the successful backups. The
priority of the most overdue jobs is important in a busy NetBackup
configuration where the backup window can close before all backups can
begin.
fewer large backups. The sizes of the tape marks vary depending on the
media type. A tape that contains many small files has more backup overhead
because each file requires an extra 512 bytes for catalog information on the
media.
■ Media sharing may be used to help maximize tape usage.
■ If you have many different volume pools, ensure that enough media is
defined to accommodate the data.
Note: Ensure that the notify scripts can be run by other before using. To do so,
run chmod 755 script_name, where script_name is the name of the script.
NetBackup uses the following scripts or batch files for collecting information
/usr/openv/netbackup/bin/backup_notify
/usr/openv/netbackup/bin/backup_exit_notify
/usr/openv/netbackup/bin/dbbackup_notify
/usr/openv/netbackup/bin/diskfull_notify
/usr/openv/netbackup/bin/mail_dr_info.sh (must be created)
/usr/openv/netbackup/bin/restore_notify
/usr/openv/netbackup/bin/session_notify
/usr/openv/netbackup/bin/session_start_notify
/usr/openv/netbackup/bin/userreq_notify
/usr/openv/netbackup/bin/parent_end_notify
/usr/openv/netbackup/bin/parent_start_notify
Scripts that run on clients:
/usr/openv/netbackup/bin/goodies/bpstart_notify
/usr/openv/netbackup/bin/goodies/bpend_notify
/usr/openv/netbackup/bin/goodies/bpend_notify_busy
To use the client scripts, the scripts must first be created on the client. Use
the procedures as described in “bpstart_notify.bat (Microsoft Windows
clients only)” on page 176 and “bpend_notify.bat (Microsoft Windows
clients only)” on page 180.
For further information, refer to the comments in the scripts.
Reference topics 173
NetBackup notify scripts
backup_notify
The backup_notify script runs on the NetBackup server where the storage
unit is located. It is called each time a backup is successfully written to media.
The parameters that NetBackup passes to this script are:
■ The name of the program doing the backup
■ The backup-image name or path
For example:
backup_notify bptm bilbo_0695316589
backup_exit_notify
The backup_exit_notify script runs on the master server. It is called to
perform site-specific processing when an individual backup completes.
Parameter Description
Parameter Description
schedtype One of the following: FULL, INCR (differential incremental), CINC (cumulative incremental),
UBAK, UARC
For example:
backup_exit_notify freddie production fulls FULL 0
backup_exit_notify danr production incrementals INCR 73
Note: Ensure that this script can be run by other on the client before it is used.
To do so, run chmod 755 script_name, where script_name is the name of the
script.
On UNIX clients, NetBackup calls the bpstart_notify script each time the
To use this script, copy the following file from the server:
/usr/openv/netbackup/bin/goodies/bpstart_notify
Modify the script and ensure that you have permission to run the script.
The bpstart_notify script runs each time a backup or an archive starts and
initialization is completed. The script runs before the tape is positioned. This
script must exit with a status of 0 for the calling program to continue and for the
in the foreground and the bpbkar process on the client waits for it to complete
before continuing. Any commands in the script that do not end with an &
The server expects the client to respond with a continue message within the
The default for BPSTART_TIMEOUT is 300. If the script needs more time than
Parameter Description
schedtype One of the following: FULL, INCR (differential incremental), CINC (cumulative incremental),
UBAK, UARC
Caution: The bpstart_notify script also runs for NetBackup catalog backups
if a .policyname[.schedule] is not specified.
For example:
bpstart_notify freddie cd4000s fulls FULL
/usr/openv/netbackup/bin/bpstart_notify.production.fulls
The first script affects all scheduled backups in the policy that are named
production. The second script affects scheduled backups in the policy that is
named production only when the schedule is named fulls.
Note: For a given backup, NetBackup uses only one bpstart_notify script and
that is the script with the most specific name. For example, if there are both
bpstart_notify.production and bpstart_notify.production.fulls
scripts, NetBackup uses only bpstart_notify.production.fulls.
The NetBackup bpbkar process creates these variables. The following are
examples of the strings that are available to the script to use to record
information about a backup:
BACKUPID=freddie_0857340526
UNIXBACKUPTIME=0857340526
To use this script, copy the following file from the server:
/usr/openv/netbackup/bin/goodies/bpstart_notify.bat
And place it on the client in the same directory as the NetBackup client binaries:
Install_path\NetBackup\bin\
Where Install_path is the directory where NetBackup is installed.
You can create bpstart_notify scripts that provide notification for all
backups or for backups of a specific policy or schedule.
To create a script that applies to all backups, name the script
bpstart_notify.bat
To create a bpstart_notify script that applies only to a specific policy or
policy and schedule combination, add a .policyname or
.policyname.schedulename suffix to the script name.
■ The following script applies only to a policy named days:
install_path\netbackup\bin\bpstart_notify.days.bat
■ The following script applies only to a schedule that is named fulls in a policy
named days:
install_path\netbackup\bin\bpstart_notify.days.fulls.bat
Caution: The bpstart_notify script also runs for NetBackup catalog backups
if a .policyname[.schedule] is not specified.
The first script affects all scheduled backups in the policy named days. The
second script affects scheduled backups in the policy named days only when the
schedule is named fulls.
For a given backup, NetBackup calls only one bpstart_notify script and
checks for them in the following order:
bpstart_notify.policy.schedule.bat
bpstart_notify.policy.bat
bpstart_notify.bat
When the backup starts, NetBackup passes the following parameters to the
script.
Parameter Description
Parameter Description
%6 Results file that NetBackup checks for a return code from the script. NetBackup uses %6 to
pass the file name and then expects the script to create the file in the same directory as the
script.
If the script applies to a specific policy and schedule, the results file must be named
install_path\netbackup\bin\BPSTART_RES.policy.schedule
If the script applies to a specific policy, the results file must be named
install_path\netbackup\bin\BPSTART_RES.policy
If the script applies to all backups, the results file must be named
install_path\netbackup\bin\BPSTART_RES
An echo 0> %6 statement is one way for the script to create the file.
NetBackup deletes the existing results file before it calls the script. After the script runs,
NetBackup checks the new results file for the status. The status must be 0 for the script to
be considered successful. If the results file does not exist, NetBackup assumes that the
script was successful.
The server expects the client to respond with a continue message within the
time that the NetBackup BPSTART_TIMEOUT option specifies. The default for
BPSTART_TIMEOUT is 300. If the script needs more than 300 seconds, increase
the value to allow more time.
For Windows 2000 clients, the bpstart_notify script can use the following
environment variables for the support of multiple data streams:
STREAM_NUMBER indicates the stream number. The first stream from a policy,
client, and schedule is 1. A 0 value indicates that multiple data streams is not
enabled.
STREAM_COUNT specifies the total number of streams to be generated from this
policy, client, and schedule.
STREAM_PID is the pid (process ID) number of bpbkar.
Caution: The bpend_notify script is run when the client is finished sending
data, but the server has not yet completed writing to media.
/usr/openv/netbackup/bin/bpend_notify
Modify the script and ensure that you have permission to run the script.
The bpend_notify script runs each time a backup or archive completes. For
archives, it runs after the backup but before the files are removed.
waits until it completes. Any commands that do not end with an & character run
serially.
The server expects the client to respond within the time that the
BPEND_TIMEOUT is 300.
If the script needs more than 300 seconds, set BPEND_TIMEOUT to a larger
value. Avoid too large a value because it can delay the server from servicing
other clients.
Parameter Description
exitstatus Exit code from bpbkar. The status is the client status and does not
indicate that the backup is complete and successful.
The client can display a status 0 when, due to a failure on the server,
the All Log Entries report displays a status 84.
Caution: The bpend_notify script also runs for NetBackup catalog backups if a
.policyname[.schedule] is not specified.
For example:
bpend_notify freddie pol_1 fulls FULL 0
/usr/openv/netbackup/bin/bpend_notify.production
/usr/openv/netbackup/bin/bpend_notify.production.fulls
The first script affects all scheduled backups in the policy production. The
second script affects scheduled backups in the policy production only when the
schedule is named fulls.
Note: For a given backup, NetBackup uses only one bpend_notify script and
that is the one with the most specific name. For example, if there are both
bpend_notify.production and bpend_notify.production.fulls
scripts, NetBackup uses only bpend_notify.production.fulls.
UNIXBACKUPTIME
BACKUPTIME
The NetBackup bpbkar process creates these variables. The following are
examples of the strings that are available to the script for use to record
information about a backup:
BACKUPID=freddie_0857340526
UNIXBACKUPTIME=0857340526
The following environment variables can be used for the support of multiple
data streams:
STREAM_NUMBER indicates the stream number. The first stream from a policy,
client, and schedule is 1. A 0 value indicates that multiple data streams is not
enabled.
indicates that the client was not finished sending all of the data. A value of 1
indicates that the client was finished sending all the of data.
You can create bpend_notify scripts that provide notification for all backups
or for backups of a specific policy or schedule.
To create a bpend_notify script that applies to all backups, name the script
bpend_notify.bat
To create a script that applies only to a specific policy or policy and schedule
combination, add a .policyname or .policyname.schedulename suffix to the
script name.
■ The following script applies only to a policy named days:
Install_path\netbackup\bin\bpend_notify.days.bat
■ The following script applies only to a schedule that is named fulls in a policy
named days:
Install_path\netbackup\bin\bpend_notify.days.fulls.bat
Caution: The bpend_notify script also runs for NetBackup catalog backups if a
.policyname[.schedule] is not specified.
The first script affects all scheduled backups in the policy named days. The
second script affects scheduled backups in the policy named days only when the
schedule is named fulls.
For a given backup, NetBackup calls only one bpend_notify script and checks
for them in the following order:
bpend_notify.policy.schedule.bat
bpend_notify.policy.bat
bpend_notify.bat
When the backup completes, NetBackup passes the following parameters to the
script.
182 Reference topics
Parameter Description
%5 Status of the operation. It is the same as sent to the NetBackup server. The status is 0 for
successful backups and 1 for partially successful backups. If an error occurs, the status is the
value associated with that error.
%6 Results file that NetBackup checks for a return code from the script. NetBackup uses %6 to pass
the file name and then expects the script to create the file in the same directory as the script.
If the script applies to a specific policy and schedule, the results file must be named
Install_path\netbackup\bin\BPEND_RES.policy.schedule
If the script applies to a specific policy, the results file must be named
Install_path\netbackup\bin\BPEND_RES.policy
If the script applies to all backups, the results file must be named
Install_path\netbackup\bin\BPEND_RES
An echo 0> %6 statement is one way for the script to create the file.
NetBackup deletes the existing results file before it calls the script. After the script runs,
NetBackup checks the new results file for the status. The status must be 0 for the script to be
considered successful. If the results file does not exist, NetBackup assumes that the script was
successful.
The server expects the client to respond with a continue message within the
time that the BPEND_TIMEOUT option specifies. The default for
BPEND_TIMEOUT is 300. If the script needs more than 300 seconds, increase the
value to allow more time.
For Windows 2000 clients, the bpend_notify script can use the following
environment variables for the support of multiple data streams:
STREAM_NUMBER indicates the stream number. The first stream from a policy,
client, and schedule is 1. A 0 value indicates that multiple data streams is not
enabled.
STREAM_COUNT specifies the total number of streams to be generated from this
policy, client, and schedule.
STREAM_PID is the pid (process ID) number of bpbkar.
Reference topics 183
NetBackup notify scripts
dbbackup_notify
NetBackup calls the dbbackup_notify script each time NetBackup completes
an offline, cold catalog backup. The script runs on the server that receives the
data for the offline catalog backup. NetBackup passes the following parameters
to this script.
Parameter Description
vsn_or_path Volume serial number (for tape) or path (for disk) used for the backup.
status Specifies whether the backup was successful and must have a value of
either SUCCESS or FAIL.
For example:
dbbackup_notify DISK /disk1/bpsync1 SUCCESS
You must be able to identify the most recent catalog backup. Modify this script
to produce a printed copy of the media ID to which the catalog backup was done.
diskfull_notify
The diskfull_notify script runs on the NetBackup server contains the
storage unit. The disk media manager (bpdm) calls this script if it encounters a
disk full condition while it writes a backup to a disk storage unit. The default
action is to report the condition and immediately try to write the data again.
(The file being written is kept open by the active bpdm).
The script can be modified to send a notification to an email address. Or
modified to perform actions such as removing other files in the affected
directory or file system. NetBackup passes the following parameters to this
script.
Parameter Description
For example:
diskfull_notify bpdm
/disk1/images/host_08193531_c1_F1
Note
In previous releases, the diskfull_notify script default condition was to
sleep for five minutes when a disk storage unit became full. To retain this
behavior upon upgrade, either:
■ Copy the netbackup/bin/diskfull_notify.old_revision_number
script to netbackup/bin/diskfull_notify, or
■ Modify the script, to change sleep 0 to:
sleep 300
mail_dr_info.sh
Use mail_dr_info.sh to send NetBackup disaster recovery information to
/usr/openv/netbackup/bin/mail_dr_info.sh
Parameter Description
parent_end_notify
NetBackup calls the parent_end_notify script each time a parent job ends.
Update the script using the following parameters.
Parameter Description
parent_start_notify
NetBackup calls the parent_start_notify script each time a parent job
starts.
Parameter Description
restore_notify
The restore_notify script runs on the server that contains the storage unit.
The NetBackup tape or disk manager (bptm or bpdm) calls the script when it is
finished sending data to the client during a restore. The script is called
regardless of whether data is sent.) NetBackup passes the following parameters
to this script.
Parameter Description
programname Name of the program doing the restore or other read operation.
For example:
restore_notify bptm bilbo_0695316589 duplication
session_notify
The session_notify script runs on the master server. It is called at the end of
a backup session if at least one scheduled backup has succeeded. NetBackup
Reference topics 187
Media and device management best practices
session_start_notify
The session_start_notify script runs on the master server. When a set of
backups is due to run, NetBackup calls this script to do any site-specific
processing before it starts the first backup. NetBackup passes no parameters to
this script.
userreq_notify
The userreq_notify script runs on the master server. NetBackup calls it each
time a request is made to:
■ List files that are in backups or archives
■ Start a backup, archive, or restore
You can alter this script to gather information about user requests to
NetBackup. NetBackup passes the following parameters to this script.
Parameter Description
action Defines the action and can have the following values: backup,
archive, manual_backup, restore, list
For example:
userreq_notif backup mercury jdoe
For a list of supported devices, server platforms, and the latest device mapping
file, see the NetBackup support web site, http://entsupport.symantec.com.
General practices
The following are general best practices for media and device management:
■ Use only Symentec documented and Symentec supported options for
NetBackup commands.
■ Refer to the NetBackup release notes to see if the methods you use are
eliminated in the current release or eliminated in future releases. The
release notes also contain information about all new functionality in each
release.
■ Use the documented methods for terminating the NetBackup Media
Manager daemons and services.
■ Periodically verify your backups using NetBackup Management > Catalog in
the NetBackup Administration Console. Also, periodically restore files to
prove that restores work correctly.
■ Always back up the NetBackup catalogs. You may also want to back up the
vm.conf and bp.conf (UNIX system) files on your media servers. Those
files contain configuration settings.
■ When you restore the NetBackup catalog (for example, master server
databases and the EMM database), use backups from the same point in time.
■ Ensure that all names and numbers for devices and all media IDs and
barcodes are unique across the entire enterprise.
■ To use devices with other applications and NetBackup controls those
devices, you must do one of the following to avoid potential loss of data:
■ Use the NetBackup tpreq command to mount media on a drive and
tpunmount to remove media from the drive. If you use these
commands, another application can control a device when NetBackup
is finished with the device.
■ Down the drive, if the drive is in the UP state.
Media management
The following are media management best practices:
■ Use the robot inventory update operation for media management.
■ Use a scratch pool for unassigned media.
Reference topics 189
Media and device management best practices
■ Configure cleaning cartridges for your tape drives, and use TapeAlert for
automatic drive cleaning if the drives support automatic cleaning.
■ Replace old media according to the life-span recommendations of the
manufacturer. Replace old cleaning media also.
■ Use robotic libraries that have a barcode reader and use only barcode labels
that the robot vendor recommends.
■ Use barcode rules for media type assignment when you inventory
multimedia libraries. Use barcode naming conventions to differentiate
between data and cleaning tapes and different physical media types. A
common convention is a prefix that identifies the type of media.
■ Before performing inject or eject commands, ensure that the media access
port is empty. Although NetBackup can handle a port that is not empty,
some libraries may have problems.
Device management
The following are device management best practices:
■ Monitor the NetBackup system log for device errors encountered.
■ Monitor devices by using the NetBackup Device Monitor.
■ Investigate the causes of all drives that are down.
■ Do not use the robotic test utilities while running backup or restore jobs.
■ Read the NetBackup Device Configuration Guide before configuring devices
on media servers (or SAN media servers).
■ Use only robots, tape drives and tape drivers, and server platforms and
hardware that are tested and supported by Symatec. For supported devices,
see the NetBackup hardware compatibility list on the NetBackup support
site.
■ Use only fully-serialized devices. A fully-serialized SCSI library should
report a serial number for the robot and also a serial number for each drive
in the robot.
■ Always configure and use pass-through paths for robotic libraries and
drives.
■ When possible, use SCSI reserve.
■ Use persistent bindings for fibre-attached devices.
■ Use the NetBackup Device Configuration wizard to configure your devices.
■ Download and install the latest device mapping file from the NetBackup
support web site before you use the Device Configuration wizard.
190 Reference topics
Using TapeAlert
■ Use consistent logical drive types for all physical drive types on all servers
in your environment. For example, use dlt as the logical drive type for all
DLT7000 drives.
■ Do not load vendor medium-changer drivers on Microsoft Windows hosts.
The default Microsoft medium-changer driver is acceptable (but is not
required) for use with NetBackup.
Using TapeAlert
TapeAlert is a tape drive status monitor and message utility. The TapeAlert
utility can detect tape quality problems, defects in tape drive hardware, and the
need to clean drives. For the tape drives that support TapeAlert, the TapeAlert
firmware monitors the drive hardware and the media. Error, warning, and
informational states are logged on a TapeAlert log page. NetBackup writes
TapeAlert conditions into:
Reference topics 191
Using TapeAlert
For more information, also see “Reactive cleaning (TapeAlert)” on page 194.
A set of TapeAlert conditions are defined that can cause the media in use to be
frozen. An additional set of conditions are defined that can cause a drive to be
downed. Table 3-13 on page 192 describes the TapeAlert codes..
and it is enabled on the drive, the NetBackup bptm process polls the drive for
TapeAlert allows reactive cleaning for most drive types. Not all platforms,
For the drives that do not support TapeAlert, you can configure and use
page 195.
For more information, see “Requirements for using TapeAlert” on page 191.
TapeAlert cleaning
A drive with TapeAlert capability tracks how many read and write errors it has
encountered within a certain time period. Although a drive can recover from
these errors, the drives sets a CLEAN_NOW or CLEAN_PERIODIC flag when a
threshold is reached.
If bptm detects that either of these flags is set, it performs a cleaning at one of
the following times:
■ At the end of a backup or a restore to the drive.
■ Before the next backup or restore to the drive.
Library-based cleaning
NetBackup does not support library-based cleaning (also known as robotic
cleaning or auto cleaning) for most robots because robotic library and operating
systems vendors have implemented this cleaning in different ways. These
different methods often interfere with NetBackup robotic control operations.
NetBackup does not define cleaning media that is used for library-based
cleaning, and the robotic library manages the cleaning media.
196 Reference topics
Frequency-based cleaning
Frequency-based cleaning occurs when the accumulated mount time exceeds
the time you specify for the cleaning frequency. NetBackup updates the mount
time for the drive each time a tape is unmounted.
The cleaning frequency is configured when you add a drive to NetBackup. You
can also change the cleaning frequency by changing the drive properties or by
using the Media and Device Management Device Monitor.
If the following conditions are met, drive cleaning occurs when the accumulated
mount time exceeds the time you specified for cleaning frequency:
■ The drive is in a robotic library that supports drive cleaning.
■ A cleaning tape is configured and available for the robotic library.
■ The cleaning tape has cleanings that remain.
NetBackup cleans the drive immediately after a tape is unmounted. Drive
cleaning never causes an unmount in the middle of an active backup. The mount
time is reset after the drive is cleaned. The cleaning frequency value remains the
same.
A cleaning can occur within a backup if the backup spans tapes. For example, if
cleaning is due after the first tape is full, NetBackup cleans the drive before it
mounts the next tape.
Media can remain in a drive for extended periods. It does not affect cleaning
frequency because NetBackup increments the mount time only when NetBackup
Operator-initiated cleaning
You can initiate a drive cleaning regardless of the cleaning frequency or
accumulated mount time of the drive. You can clean stand-alone drives or
Reference topics 197
Volume pool and volume group overview
robotic drives if a cleaning tape of the correct media type and residence for the
■ The value for the mount time is greater than the cleaning frequency.
■ The TapeAlert CLEAN_NOW or CLEAN_PERIODIC flag is set.
and either of the following conditions are true:
■ The drive is a stand-alone drive and a cleaning tape is not defined.
■ The drive is a stand-alone drive and no cleaning tape has any cleanings that
remain.
NetBackup displays NEEDS CLEANING as follows:
■ The Tape Cleaning Comment column of the Drive List in the Devices node of
the NetBackup Administration Console.
■ The comment field of the output from the tpclean -L command.
Note: NetBackup does not control the cleaning tapes that library-based cleaning
uses.
You can specify the number of cleanings that are allowed for a cleaning tape.
This number is decremented with each cleaning. When the number of cleanings
is zero, NetBackup stops using the cleaning tape. You can use a new cleaning
tape or increase the number of cleanings that are allowed for the tape.
Symantec suggests that you follow the recommendations from cleaning tape
vendors for the amount of tape usage. If you use a cleaning tape past its
recommended life, cleaning delays may occur (due to excessive tape position
operations) and drives may be downed.
Volume pools
The volume pool concept is relevant only for NetBackup storage units and does
not apply to disk storage units.
Volume pools protect volumes from access by unauthorized users, groups, or
applications. You can create volume pools for user groups or other reasons, and
as you add volumes, associate them with the appropriate pool. You can also
move unassigned volumes to a different pool.
With the exception of the CatalogBackup, NetBackup, and DataStore volume
pools, you must create a volume pool before you can add volumes to it. By
default, NetBackup creates volume pools named None, NetBackup,
CatalogBackup, and DataStore.
Volume groups
Volume groups show the location of a volume, such as the robot in which it
resides. If you move a volume physically, you also must move it logically (a
logical move means to change the volume attributes to show the new location).
Volume groups are convenient for tracking the location of volumes, such as the
case when a volume is moved off-site.
Volume groups let you perform operations on a set of volumes by specifying the
group name rather than each individual media ID of each volume. Operations
include moves between a robotic library and a stand-alone location or
deletetions from NetBackup.
Standalone
Robotic NB_pool
Off-site 1
Group 1 Group 2
Group 3 Group 4
Off-site 2
In Figure 3-2 on page 200, members of the same volume pools are in different
volume groups. Note that the data is stored on separate volumes by assigning
different volume pools. The volumes in a pool can be in more than one physical
location and in more than one volume group.
In this example, the volumes in the pool NB_pool_dept_1 are spread among the
rob_A, standalone1, and off-site volume groups. These groups also have
volumes from more than one pool (though the volumes in each group must all be
the same type).
200 Reference topics
Volume pool and volume group overview
Robot A Standalone
Group Standalone Group
rob_A off-site
Group
standalone1
NB_pool
_dept_1
NB_pool
_dept_2
Robot B
Group
rob_B
NB_pool
_dept_3
You also can configure a scratch pool from which NetBackup can transfer
volumes when a volume pool has no media available. For more information, see
“Scratch volume pools” on page 200.
Group
Group
rob_A rob_C
NB_pool_dept_1
Scratch_pool
Robot B - TL8
Group
rob_B
NB_pool_dept_2
Barcode overview
Barcode overview
When a robotic library has a barcode reader, it scans the media for barcodes and
saves the results. The results associate the slot number and the barcode with the
media in that slot. NetBackup obtains barcode and slot information from the
robotic library.
Barcode advantages
NetBackup functions well whether or not barcodes are used. However, Symantec
suggests that you use media with barcodes in the robots that can read barcodes.
Barcodes offer the following advantages:
■ Automatic media ID assignment. When you add new media to a robot,
NetBackup is able to assign media IDs according to the criteria that you
specify.
■ More accurate tracking of volume location. A robot inventory update can
determine which volumes are in a robot.
■ Increased performance. Not using barcodes can adversely affect
performance for some robots. A robot that reads barcodes performs a scan
each time it moves a tape. The robot stores the correct barcode in memory or
verifies a previously saved barcode. However, if a tape does not have a
barcode, the robot retries the scan multiple times, degrading performance.
■ When you purchase barcode labels for use with NetBackup, always follow
the robotic library vendor’s recommendations. Ensure that the barcodes
have the correct number of characters.
■ Barcodes can represent any combination of alpha and numeric characters,
but different robots support different lengths of barcodes. See the robot
vendor’s documentation to determine the requirements for a specific robot
type.
■ Use barcodes without spaces (at the beginning, at the end, or between any
characters). Otherwise, the robot or NetBackup may not read them correctly.
■ Volumes in an API robot have a real or a logical barcode. This volume
identifier is used as the NetBackup media ID. This volume identifier is the
volume serial number in ACS, TLH, and TLM robots.
■ For API robots, the barcode for a volume must be identical to the NetBackup
media ID.
You can match barcodes to media IDs by getting custom labels in the same
series as your media IDs. For example, to match a set of media IDs from
AA0000 to ZZ9999, get barcode labels in that series.
■ When a robotic library can contain more than one media type, you should
assign specific characters in the barcode to different media types using
media ID generation rules. Also, you should use barcodes to differentiate
between data tapes and cleaning tapes or to differentiate between volume
pools.
Barcode rules
A barcode rule specifies criteria for assigning attributes to new robotic volumes.
NetBackup assigns these attributes using the barcode for the volume that the
robotic library provides and your barcode rules.
In NetBackup, you choose whether to use barcode rules when you set up the
robot inventory update operation. The barcode rules are stored on the EMM
server .
■ If the media types match, NetBackup assigns the attributes in the rule to the
volume. The attributes include the media type, volume pool, maximum
number of mounts (or number of cleanings), and description.
Note: NetBackup does not use barcode rules if a volume already uses a barcode.
Checking barcodes
In the robots that have barcode readers, NetBackup verifies the barcode to
ensure that the robot loads the correct volume. If the barcode on the volume
does not match the barcode in the EMM database, NetBackup:
■ May assign the request a pending status (for media-specific jobs such as a
restore)
■ May use another volume (for backup or duplicate jobs)
■ May fail the job (cold catalog backup jobs)
■ Check the Device Monitor to find a suitable drive and mount the requested
volume in that drive.
■ Move the volume into the robot, update the volume configuration to reflect
the correct location for the media, and resubmit the request.
If the volume is labeled (tape or optical platter), the automatic volume
recognition daemon reads the label and the drive is assigned to the request. If
the volume is unlabeled and not associated with a robot, the operator manually
assigns the drive to the request.
Refer to the previous table for example barcode rules for the following
examples. Assume that you select the following media settings (update options)
for the update operation for a new 8-mm volume in a TL8 robot:
uses the rule with the barcode tag of TL8 and assigns the following attributes for
the volume:
If a new volume has a barcode of TL000001, NetBackup uses the rule with the
barcode tag of TL and assigns the following attributes for the volume:
Note: To use media ID generation rules, the robot must support barcodes and the
robot cannot be an API robot. Media ID generation rules are saved in the Media
Manager configuration file (vm.conf).
Using media ID generation rules allows you to override the default media ID
naming method NetBackup uses. The default method uses the last six characters
of the barcode the robot provides to generate the media ID.
For example, two eight-character barcodes are S00006L1 and 000006L1. If you
do not specify any media ID generation rules, NetBackup uses the last six
characters of the barcode to generate its media IDs. In this example, the same
media ID for the two barcodes would be created (0006L1) .
In a rule, you can control how NetBackup creates media IDs by specifying which
characters of a barcode are used in the media ID. You also can specify that
alphanumeric characters are to be inserted into the ID.
You can define multipe rules to accommodate your robots and the barcode
lengths. You can define rules to specific robots and for each barcode format that
has different numbers of characters in the barcode. Multiple rules allow
flexibility for the robots that support multiple media types.
Replacing devices
If you replace an existing device in your configuration, the serial number of the
new device is different than the old device. NetBackup recognizes the change
and updates the EMM database without restarting ltid. NetBackup also
recognizes device firmware upgrades. For devices on NetBackup 5.x hosts, you
must restart ltid before NetBackup recognizes the new device.
In upgrades from NetBackup environments earlier than 6.0, devices retain their
serial numbers. In NetBackup 6.0 and later, a change to a serial number
formatting algorithm may affect a small number of tape drives and robotic
libraries. Those devices may be configured as unserialized or configured with a
different serial number. Therefore, NetBackup integrity checks that query the
Reference topics 207
Changing your hardware configuration
device serial number and compare it with the serial number in the database may
fail. If so, a device may be unusable (such as the tape drive may be downed).
Integrity checks occur when ltid performs automatic path correction or when
the run-time Plug-n-Play code (Windows only) performs serial number checks.
In such cases:
■ Update the serial number or reconfigure the device so that the new serial
number to be stored in the EMM database. For procedures, see
■ “To swap a serialized drive or to update drive firmware on a single
host” on page 207
■ For a shared drive, “To swap a shared serialized drive or to update drive
firmware on a shared drive” on page 207
■ Disable runtime serial number checks by using the
AUTO_PATH_CORRECTION vm.conf option.
new hardware and produce a report that shows the new and the replaced
hardware.
4 Ensure that all servers that share the new hardware are up and that all
NetBackup services are active.
5 Run tpautoconf with the -replace_drive drive_name -path
path_name options or -replace_robot robot_number -path robot_path
options.
The tpautoconf command reads the serial number from the new
hardware device and then updates the EMM database.
6 If the new device is an unserialized drive, run the device configuration
wizard on all servers that share the drive.
If the new device is a robot, run the device configuration wizard on the
server that is the robot control host.
7 Up the drive. In the Device Monitor, select the new drive. From the Actions
menu, select Up Drive.
Note: If you use NetBackup Vault and plan to decomission a media server,
contact Symantec Consulting for help with this task.
Use the following procedure to decommission a server (the old_server) and move
its media to a new media server (the new_server). If you do not do the following
and a subsequent restore requires media that is associated with the old media
server, you must import the media. Importing media consumes more time than
performing the following procedure.
2 Select another server or the master server (new_server) to manage the tapes
from the old_server.
Run the bpmedia command for each tape that has active images as
identified in step 1. The command replaces the old_server with the
new_server in the EMM database and updates the images database on the
master server.
bpmedia -movedb -ev media_ID -oldserver old_server
-newserver new_server
3 Add the following command to the end of the bp.conf file on the master
server. The command allows restores from the media that are associated
with the old_server to occur from a new_server.
FORCE_RESTORE_MEDIA_SERVER = old_server new_server
4 Use the NetBackup Administration Console to move the tapes that are in the
robots that are attached to the old_server to non-robotic status
(stand-alone). Select each robot that is attached to the old_server, highlight
all of the tapes, and move them to stand-alone.
5 Use the NetBackup Administration Console to delete the drives and then the
robots from the old_server.
6 Use the NetBackup Administration Console to delete all storage units that
use the robots that are associated with the old_server.
7 If any robots from the old_server are reused on other media servers, do the
following:
a Power down the affected servers, disconnect the robots from the old
servers, and then connect them to the new media servers. Verify that
the operating systems on the new media servers recognize the robots.
b Use the NetBackup Administration Console to add the robots and drives
to those media servers. You can use the NetBackup Device
Configuration wizard.
c Use the NetBackup Administration Console to create the appropriate
NetBackup storage units.
d Use the NetBackup Administration Console to inventory the robots that
are attached to the new_server. The inventory updates the location of all
tapes in these robots.
8 Modify any policies that explicitly specified any of the storage units on the
old_server. These policies must be changed to point to any other defined
storage units in the NetBackup configuration or to Any Available, as
appropriate.
210 Reference topics
How NetBackup selects drives
9 Remove all reference to the old_server in the bp.conf files (UNIX only) and
vm.conf files on the NetBackup master server and all NetBackup media
servers.
10 Use the nbemmcmd command to remove the host aliases and host names
that reference the old_server. Run nbemmcmd -listhosts to verify that all
references have been removed.
11 Update the server list on all clients to no longer refer to the old_server.
Restart the NetBackup daemons (or services) on any system that was
updated.
■ SPC-2 SCSI reserve. (The default option.) This option 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.
■ No protection. Other HBAs can send the commands that may cause a loss of
data to the tape drives.
You can configure access protection for each NetBackup media server. The
protection setting configures tape drive access protection for all tape drive
paths from the media server on which the setting is configured. You can
override the media server setting for any drive path.
SCSI reservations provide protection for NetBackup Shared Storage Option
environments or any other multiple-initiator environment in which drives are
shared.
SCSI access protection is used on tape drives only.
adapters (HBAs) from issuing any commands that can cause data loss.
When the NetBackup process is finished with the drive, NetBackup unloads the
drive and sends a persistent reserve clear command to the drive. The command
SCSI persistent reserve also provides device status detection, which NetBackup
The reservation does not prevent other applications on the host that has the
reservation from using the same device and from causing data loss. For
Also, other HBAs can clear or release an SCSI persistent reservation. Therefore,
an application can clear another HBAs reservation (although it should not do
so).
Reference topics 213
How NetBackup reserves drives
After the NetBackup process has finished with the media, it issues an SPC-2
SCSI command to release the reservation during the unmount operation. The
release frees the device for access by another HBA.
SCSI reserve does not provide a method to determine if a device is reserved. Only
the reservation owner (the host bus adapter) can release the reservation.
However, these limitations do not interfere with NetBackup operations in most
environments.
A negative consequence of SPC-2 SCSI reserve occurs if the HBA that owns the
reservation fails. A device that an HBA reserves stays reserved until the
reservation is removed or broken. Only the original HBA can remove the
reservation, which means the system must be available. If the HBA that owns
■ SCSI reset
■ Bus device reset
■ LUN device reset
■ Power cycle
■ Fibre channel link actions may break reservations.
SPC-2 SCSI reserve commands are mandatory for all SCSI-2 and SCSI-3 devices.
See the SCSI 2 standard for a detailed description of SCSI reserve command
Also, the NetBackup Administration Console Device Monitor or the output from
the vmoprcmd command shows PEND in the Control column.
If a conflict occurs, a reservation problem may exist. If the HBA that reserves
the drive is unavailable (for example, due to a system crash or hardware failure),
it cannot release the reservation. NetBackup cannot release or break an SPC-2
SCSI reservation automatically. You must force a release or break the
reservation to make the drive available, even for a failover server in a cluster
environment.
When the conflict is resolved, the following message is written to the log:
Reservation Conflict status cleared from DRIVENAME (device NUMBER)
Forcing a release
To force a release of an unavailable HBA’s SPC-2 reservation, you can use the
This option requests that all hosts that are registered to use the drive issue
Issue the vmoprcmd command on the host that is the device allocator (DA host).
Alternatively, use the -h option of the command to specify the DA host. The DA
Caution: You can use this command after a PEND status has been displayed in
the NetBackup Administration Console Device Monitor. However, do not issue
this command during backups.
For more information about using the vmoprcmd command, see NetBackup
Commands for UNIX and Linux or NetBackup Commands for Windows.
216 Reference topics
How NetBackup reserves drives
Breaking a reservation
If you cannot release an SPC-2 SCSI reservation, you can try to use an operating
system command that forces a device reset. A device reset breaks a reservation.
The procedure depends on the operating system type.
Caution: The reset operation may reset other devices in your configuration. Loss
of data is also possible. You should first try alternate methods to break the
reservation on a device (using switch and bridge hardware).
■ On HP-UX systems, you must disable the operating system's use of SPC-2
SCSI reserve. For instruction, see “Enabling SPC-2 SCSI reserve” in the
“Hewlett-Packard HP-UX” chapter of the NetBackup Device Configuration
Guides.
■ Depending on your tape drives, you may have to disable the operating
system’s use of SPC-2 SCSI reserve. AIX and Solaris may require such a
change. For more information, see the appropriate operating system
chapter of the NetBackup Device Configuration Guide.
The NetBackup implementation of SCSI persistent reserve and SPC-2 reserve
has the following limitations:
■ SCSI persistent reserve and SPC-2 reserve do not apply to NDMP drives. The
NDMP filer is responsible for providing exclusive device access.
■ Third-party copy configurations must be configured correctly. To retain
reservation of a tape device during a third-party copy backup, you must
configure the NetBackup mover.conf file. For procedures, see the
NetBackup Snapshot Client Administrator's Guide. Do not use SCSI
persistent reserve on the drive paths that are used for third-party copy
backups.
■ With SPC-2 SCSI reserve, devices may remain reserved after a failover in
cluster environments or multipath environments with failover capability.
You cannot use SPC-2 SCSI reserve if the following are true: the failover
does not break the device reservations and those devices that were in use
during the failover must be available without manual intervention. You can
use SCSI persistent reserve.
■ If a drive path changes, backups and restores fail. Therefore, jobs fail in
cluster environments or any multipath environments that share paths
dynamically. If you cannot disable dynamic path sharing, you cannot use
SPC-2 SCSI reserve or SCSI persistent reserve in NetBackup. HP Tru64 is a
system that uses dynamic path sharing.
causes the actual position to be greater than the expected position at the end of
the backup process, the following occurs:
■ The tape is frozen.
■ The backup fails.
■ The following error message entry is placed in the bptm log:
FREEZING media id xxxxxx, too many data blocks written, check
The backup data may be usable. If so, you can import the image using the
NetBackup bpimport command so the data is available for restores.
data loss. The most common configuration error is a failure to configure the
A less common error may be in the tape driver's configuration data, such as in
For information about tape driver configuration, see the NetBackup Device
Configuration Guide.
EOM message from the drive). The new volume must meet all of the
following criteria:
■ Is the correct media type.
■ Is for the correct robot type (if applicable).
■ Is located in the requested robotic peripheral (if applicable).
■ Resides on the requested host.
■ Is in the correct volume pool.
■ Is not currently assigned (not already allocated to NetBackup).
■ Is not expired (if an expiration date is defined in NetBackup).
■ Has not exceeded the maximum number of mounts allowed.
■ If more than one volume qualifies, NetBackup chooses the volume that was
least recently used. NetBackup then adds it to the media catalog and assigns
it the specified retention level.
■ If there are no unassigned volumes of the requested type, the backup
terminates with an error message that no media was available.
Spanning media
After an end of media (EOM) is reached, automatic media selection depends on
whether NetBackup is configured to allow backups to span media, as follows:
■ NetBackup spans media if the NetBackup Media host property Allow
backups to span media is specified for the server. In this case, NetBackup
uses another volume to start the next fragment and the resulting backup is
composed of fragments on different volumes.
■ NetBackup does not span media if Allow backups to span media is not
specified. In this case, the backup terminates abnormally and the operation
is retried according to the NetBackup Global Attributes host property,
Schedule backup attempts.
Spanning media
Media selection after an end of media (EOM) condition depends on whether
NetBackup is configured to allow backups to span media, as follows:
■ NetBackup spans media if the media server host property, Allow backups to
span media, is specified for the server. NetBackup selects another volume to
Reference topics 223
Media formats
begin the next fragment, and the resulting backup has data fragments on
more than one volume.
■ After an EOM condition, NetBackup attempts to use an unassigned
volume rather than one that already has images on it. NetBackup
checks the EMM database for a volume that is the correct media type,
in the correct volume pool, and so on.
■ If a suitable unassigned volume is unavailable, NetBackup selects a
volume.
■ NetBackup does not span media if Allow backups to span media is not
specified. The backup terminates abnormally when the end of media is
reached. The operation is rescheduled according to the master server host
property Schedule backup attempts.
When NetBackup spans media and an EOM is encountered on a stand-alone
drive, you can direct NetBackup to wait until a volume is loaded in a compatible
stand-alone drive. NetBackup then does not search for other media or generate a
pending mount request. The wait period is helpful when a gravity feed tape
stacker takes a long time to load the next media in the drive. (A gravity feed tape
stacker is not controlled by software.)
To direct NetBackup to wait, specify the Media request delay media server host
property. This property specifies the number of seconds NetBackup waits to use
a volume that is loaded in a compatible drive before looking for another drive.
NetBackup also waits to generate a pending mount request during tape span
operations. The Media request delay property is effective only when
stand-alone drive extensions are enabled.
is encountered. Also, the media is ejected if the drive needs to be used with
See the NetBackup Commands for UNIX and Linux for detailed information on
Media formats
NetBackup writes media in a format that allows the position to be verified before
appending new backups. The format for tape and optical media differs slightly
because of characteristics of the media.
224 Reference topics
Media formats
The following symbols are used in the media format descriptions in the
following subsections.
Symbol Description
* Tape mark.
BH1 ... BHn Backup Headers (1024 bytes). One for each job that is part of the set
of jobs being multiplexed
When you add a new backup image, the tape is positioned to the EH and the
When NetBackup encounters the end of media during a write, it terminates the
tape with two tape marks and does not write an EH.
the standard tape format, NetBackup does not write empty backup headers (EH).
To append backup images to QIC media, NetBackup positions to the end of data
Fragmented backups
For fragmented backups, the media format is similar to the standard tape
format. The difference is that NetBackup breaks the backup image into
fragments of the size that you specify when you configure the storage unit. The
following is an example:
MH * BH Image (frag 1)* BH Image (frag 2)* BH Image (frag n) * EH *
Fragmentation is intended primarily for storing large backup images on a disk
type storage unit. The following are some benefits of image fragmentation:
■ For multiplexed backups, faster restores because NetBackup can advance to
the specific fragment before starting its search for a file.
■ Faster restores from any backup images that NetBackup Storage Migrator
migrated. For example, if a 500-MB backup is stored in 100-MB fragments,
Storage Migrator has to retrieve only the fragment that has the files. Storage
Migrator does not have to retrieve the entire 500 MBs.
Note: If an error occurs in a backup, the entire backup is discarded and the
backup restarts from the beginning. It does not restart from the fragment where
the error occurred. Exception: checkpoint and restart backups resume from the
last checkpoint fragment.
Multiplexing format
The tape format for multiplexed backups is as follows:
By default, the data image is in 64-kilobyte blocks. Each block also contains 512
bytes that are reserved for multiplexing control information and to identify the
When a job ends or a new job is added to the multiplexing set, NetBackup writes
a tape mark and starts multiplexing the revised set of jobs. The following is an
example:
MH * BH1 BH2 BH3 Image* BH2 BH3 Image* BH2 BH3 BH4 Image. .
Spanning tapes
By default, NetBackup spans a backup image to another tape if it encounters the
end of media during a backup. The format is the same as described for
fragmented backups. The first fragment on the next tape begins with the buffer
of data where the end of media occurred.
226 Reference topics
Media Manager commands
The following is the first tape format (NetBackup does not write an EH, and
tlhd The Tape Library Half-inch robotic daemon. This Applies only to
daemon is started by ltid. NetBackup
Enterprise
Server.
tlmd The Tape Library Multimedia daemon. This daemon is Applies only to
started by ltid. NetBackup
Enterprise
Server.
kill pid Stops the process for the daemon with the specified pid
(process id).
This is a system command with a path of
/usr/bin/kill or /bin/kill.
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 the Device Configuration Wizard
queries the devices.
■ Each robot and each drive returns a unique serial number.
■ For any robots in the configuration, the wizard issues an additional
command. The robot returns the number of drives and the serial number for
each of the drives in the robot. The wizard uses the information to
determine the correct drive number for each drive in the robot.
NetBackup uses the information to construct your configuration.
If a device does not support serialization, ask the vendor for the new firmware
that returns serial numbers. Even with the proper firmware, some devices
Reference topics 229
Device discovery overview
require the vendor to perform another action to enable serialization for the
device.
If you know that your devices do not support serialization, make sure that you
The greater the number of drives and robots in your configuration that do not
In some cases, you can add support for new or upgraded devices without waiting
for a release updates from Symantec. For information about how to update this
file, see the NetBackup Administrator’s Guide, Volume I.
Related topics
configuration. For information about the robotic test utilities, see the NetBackup
Troubleshooting Guide.
After you create device files and configure NetBackup, you can verify the
configuration.
2 Start ltid, which starts the Automatic Volume Recognition daemon (avrd).
You must stop and restart ltid to ensure that the current device
configuration has been activated.
The following point applies only to NetBackup Enterprise Server.
If robotic control is not local to this host, also start the remote robotic
control daemon.
3 Use the robotic test utility to mount a tape on a drive.
4 Use the NetBackup Administration Console Device Monitor to verify that
the tape was mounted on the correct robot drive.
Verify configuration example
For example, assume a TLD robot includes three drives and the operating
system includes the following device paths:
■ Drive 1: /dev/rmt/0cbn
■ Drive 2: /dev/rmt/1cbn
■ Drive 3: /dev/rmt/3cbn
Also assume that in step 3 in “To verify the configuration (UNIX),” you
requested that the tape be mounted on drive 1. If the device path for the drive is
configured correctly, the Device Monitor shows that the tape is mounted on
drive 1.
If the Device Monitor shows that the tape is mounted on a different drive, the
device path for that drive is not configured correctly. For example, if the Device
Monitor shows that the tape is mounted on Drive 2, the device path for drive 1 is
incorrect. Replace the drive 1 device path (/dev/rmt/0cbn) with the correct
device path (/dev/rmt/1cbn) for drive 2. You may need to use a temporary
device path while making these changes. You also know that the device path for
drive 2 is incorrect. Possibly, the device paths were swapped during
configuration.
Use the robotic test utility to unload and unmount the tape from drive 1. Repeat
the test for each drive.
The following point applies only to NetBackup Enterprise Server.
If the path to the drive where the tape is mounted is not on the host with direct
robotic control, you may have to unload the drive with a command from another
host or from the drive’s front panel.
Device Monitor shows the tape mounted on drive 2, the SCSI coordinates for
drive 1 are incorrect. Replace the drive 1 SCSI coordinates (5,0,0,0) with the
correct SCSI coordinates (5,0,1,0) for drive 2. You also know that the SCSI
coordinates for drive 2 are incorrect. Possibly, the SCSI coordinates were
swapped during configuration.
Use the robotic test utility to unload and unmount the tape from drive 1. Repeat
the test for each drive.
The following point applies only to NetBackup Enterprise Server.
If the data path to the drive where the tape was mounted is not on the host with
direct robotic control, you may have to unload the drive with a command from
another host or from the drive’s front panel.
Requesting tapes
The tpreq command allows you to request a tape of a particular density and
specify various options, such as the access mode. This command reserves a
single drive and creates a file in the current working directory (unless a full path
is specified). The file acts as a symbolic link to the tape and all subsequent access
to the tape is through this file name. Users do not have to be concerned with the
full path to a specific device file.
The information you supply on the tpreq command is required for use by the
Media Manager device daemon and used to validate all access requests to the
tape file.
For all types of tapes, the tape is actually mounted and assigned when you enter
the tpreq command.
236 Reference topics
Tape I/O commands
By default, the drive assigned is one which supports DLT cartridge tapes, using
the density dlt. You can use the density option on tpreq to request a drive that
supports another density. For a list of supported densities and drive types, see
the tpreq man page or the online help for the Pending Requests pane in the
NetBackup Administration Console..
The density for the physical write is not selected automatically on drives. It is
requested, so an operator can satisfy the correct drive. Density is determined by
the /dev device name that was used when the drive was added to the Media
Manager configuration or by the buttons selected on the drive.
A tpreq command must include a media ID and a file name. If the tape volume
is associated with a volume pool (configured using Media Manager), the name of
the volume pool may also be specified using the -p parameter. If the pool name is
specified, the name will be validated against the pool name associated with the
media in the EMM database.
See tpreq in the NetBackup Commands for UNIX and Linux for more
information.
drive_mount_notify script
When a tpreq command is executed, a call is made to execute the
drive_mount_notify script immediately after the media has been
successfully placed in a pre-selected drive.
This script allows user special-handling to occur at this point. Control is then
returned to NetBackup to resume processing. The script is only called from the
tpreq command for drives that are in robots and is not valid for standalone
drives.
This script is located in the /usr/openv/volmgr/bin/goodies directory. If
you wish to use this feature, this script should be activated and put into the
/usr/openv/volmgr/bin directory.
Usage information is documented within the script.
tpreq example
The following sample tpreq command reserves a tape drive and creates a
symbolic tape file:
/usr/openv/volmgr/bin/tpreq -f tape1 -m jlr01 -a w -d qscsi
This command creates a file named tape1in the current working directory and
links the file to the drive containing the tape volume having the media ID of
JLR01. The access mode for the tape file is set to write and a 1/4-inch cartridge
drive is assigned.
Reference topics 237
Tape I/O commands
mt Option Operation
eof, weof Writes end-of-file tapemarks at the current position on the tape
according to the count option on mt.
fsf, bsf Spaces forward or backward the number of tapemarks on the count
option.
fsr, bsr Spaces forward and backward the number of records according to the
count option on mt. bsr is only supported for the undefined record
type.
positioned to the beginning of the tape volume associated with the file:
mt -f tape1 rewind
The count option is not used for the rewind operation. If a count is specified, it is
ignored.
See tpunmount in the NetBackup Commands for UNIX and Linux for more
information.
drive_unmount_notify script
When a tpunmount command is executed, a call is made to execute the
drive_unmount_notify script.
This script allows user special-handling to occur at this point. Control is then
returned to NetBackup to resume processing. The script is only called from the
tpreq command for drives that are in robots and is not valid for standalone
drives.
This script is located in the /usr/openv/volmgr/bin/goodies directory. If
you wish to use this feature, this script should be activated and put into the
/usr/openv/volmgr/bin directory.
Usage information is documented within the script.
0+473 records in
3 The second tar is performed, starting at the end of the previous data. The
records out information is used for the oseek parameter.
tar -cvf - /home/arh/.cshrc|dd of=tape ibs=10240
obs=10240 oseek=189
4 The disk is unmounted, as follows.
Reference topics 239
Tape I/O commands
tpunmount tape
6 The second tar image is listed. To access the data, the user must know
where it is located for the iseek parameter.
dd if=tape ibs=10240 obs=10240 iseek=189 | tar -tvf
rw-r--r--357/110 2386 Jul 9 14:01 1992
/home/arh/.cshrc
Note: AFS is no longer available from IBM and IBM has ended support for AFS.
AFS is not supported with 6.5 clients. AFS continues to be supported with
NetBackup 5.x clients that run under 5.x or 6.0 servers.
Installation
System requirements
■ The AFS file servers that can be NetBackup AFS clients:
■ Solaris 7 and HP-UX 11.0, or IBM AIX 4.3.3 platforms
■ NetBackup 5.0 or 5.1 clients
■ AFS level 3.6 or later installed
Configuration
To configure backups for NetBackup AFS clients, add an AFS policy to the
NetBackup configuration on the master server. The requirements are the same
as for other NetBackup policies, except for the differences that are mentioned
here. To back up the files and directories that are not in AFS volumes, create
separate policies.
242 Using NetBackup with AFS
Configuration
Client list
In the client list, specify the names of the AFS file servers to be backed up. These
systems must have the NetBackup client installed.
Backup selections
In the backup selection list for the AFS policy, specify the AFS volumes and vice
partitions to be backed up. The following example shows both volumes and vice
partitions:
user.abc
/vicepb
/vicepc/user.*
Note: NetBackup supports the maximum AFS 3.6 volume size of 8 GB.
■ REMOVE_BACKUP_VOLUMES
This directive causes NetBackup to remove .backup volumes after
performing the backup. The directive removes .backup volumes that are
created using the CREATE_BACKUP_VOLUMES directive or created by
another mechanism.
■ SKIP_SMALL_VOLUMES
This directive allows small or empty volumes to be skipped during backups.
For example:
SKIP_SMALL_VOLUMES=5
In this example, NetBackup skips volumes ≤ 5 KB. Specify any number for
SKIP_SMALL_VOLUMES
SKIP_SMALL_VOLUMES
/user.abc
/vicepb
Regular expressions
NetBackup supports regular expressions in backup selection list entries. These
are useful to perform the following actions:
■ Add or move volumes without having to change the backup selection list.
■ Add vice partitions without having to change the backup selection list.
■ Split volumes and vice partitions on AFS file servers into groups that can be
backed up by separate policies. The different groups allow for concurrent
backups or multiplexing.
The following examples use regular expressions:
user.[a-m]*
/vicep[a-c]
Automatic backup
The most convenient way to back up NetBackup for AFS clients is to configure
an AFS policy and set up schedules for automatic, unattended backups.
Manual backup
The administrator on the master server can use the NetBackup Administration
Restores
The administrator performs all restores on either the NetBackup AFS client or
the master server. Restores are performed on the basis of volumes. To restore a
vice partition, the administrator must select all the volumes in that partition.
Caution: If the Overwrite Existing Files option is selected, the volumes are
overwritten. All changes or files that were created since the last backup are lost.
Troubleshooting
Troubleshooting backups
To increase the level of detail in the logs:
■ Add the VERBOSE option to the /usr/openv/netbackup/bp.conf file on
the NetBackup for AFS client.
■ Create the following debug log directory on the NetBackup for AFS client:
/usr/openv/netbackup/logs/bpbkar
If the AFS backup terminates with a status code of 9, the code indicates that
NetBackup AFS client software was not properly installed. (An extension
release update is needed.)
If the AFS backup terminates with a status code of 78, the code indicates an
AFS vos command failure. (afs/dfs command failed) The NetBackup
Problems Report provides additional information as to why the command
failed. The bpbkar debug log shows the command that was run. Run the
vos command manually to attempt to duplicate the problem.
Also, examine the /usr/openv/netbackup/listvol file on the
NetBackup client for irregularities. The vos listvol command can
demand much from system resources so NetBackup caches the output of
the vos listvol command in this file. NetBackup uses the cached
listvol file to obtain the volume list instead of running another vos
listvol command. (If the cached listvol file was created less than four
hours before the backup.)
Troubleshooting restores
If the restore of an AFS volume fails, check the restore process log for additional
information. Create a /usr/openv/netbackup/logs/tar debug log
directory if a vos restore command failure is indicated. Then, retry the
operation and check the resulting log to see that the vos restore command
was run.
Chapter 5
Intelligent Disaster
Recovery
Intelligent Disaster Recovery (IDR) for Windows is an automated disaster
recovery solution. It allows administrators to recover Windows computers
quickly and efficiently after a disaster. The IDR wizards help administrators
prepare for disaster recovery and recover computers to their state before the
disaster.
This chapter contains the following sections:
■ “Changes for NetBackup 6.0 and later” on page 248 explains limited
supported for IDR in NetBackup 6.0 and later.
■ “Supported Windows editions” on page 248 documents the Windows
versions that IDR supports.
■ “Overview of IDR use” on page 250 explains the main steps that are involved
in using the disaster recovery software.
■ “About the DR files” on page 250 introduces the Disaster Recovery files and
explains their importance in disaster recovery.
■ “Configuring NetBackup policies for IDR” on page 251 explains how to
configure the policies that contain the clients that use IDR.
■ “Backing up the protected computer” on page 252 explains that you must
back up the computer before you create the bootable media that is used in
recovery.
■ “Creating IDR media” on page 252 explains how to use the IDR Preparation
Wizard to prepare the bootable media that is used to recover data.
■ “Updating IDR media” on page 258 explains how and when to update the
IDR media so it is always ready when it is needed.
248 Intelligent Disaster Recovery
Changes for NetBackup 6.0 and later
directory on the client. The DR files that are generated after a backup are named
in the format netbackup_client_name.dr. For example, if the client name is
bison, the DR file is bison.dr.
Note: IDR requires that the DR file name match the computer name of the client.
That is, if the network recognizes the computer name bison, the DR file must be
named bison.dr. If the NetBackup client name is different, rename the DR file
that is created after each backup before using it in a recovery. (Use the format
computer_name.dr.)
On the NetBackup master server, the DR files for all clients are stored in the
NetBackup catalog on the server.
media, which includes the DR file used in recovery. The NetBackup master
server that performs the backup must be configured to collect disaster recovery
file.
You can prepare IDR bootable media if differential or incremental backups have
Ensure that all local drives are backed up. For Windows 2000 computers, ensure
Ensure that any utility partitions are backed up. Utility partitions are small
partitions created on the hard drive, usually by the computer vendor, that may
You must prepare the media before a disaster. For CD-R or CD-RW, you should
also try booting from the media before a disaster occurs to ensure that your
For more information, see “Step 1: Boot your computer” on page 262.
Note: IDR does not support bootable diskette media for Windows XP or Windows
Server 2003.
Consider the following factors to decide between diskettes and CD-ROM media:
■ Diskettes work on most computers but require more time for preparation
and recovery than CDs.
■ Diskettes require the Windows installation CD during recovery.
■ Because of space limitations, diskettes hold SCSI driver information for only
one computer. To use one set of diskettes to protect multiple computers,
choose one computer that represents all the other computers and create
bootable media for it. For computers with different SCSI drivers, create a set
of diskettes for each computer with a different driver.
■ CDs require less time for preparation and recovery than diskettes.
■ CD media has enough space to store SCSI driver information for multiple
computers. Use a single CD for multiple computers during disaster recovery.
254 Intelligent Disaster Recovery
Creating IDR media
■ CD media requires that the protected computer have a BIOS that supports a
CD boot.
■ CD media requires CD writing hardware. The protected computer does not
require a CD writer. The IDR Preparation Wizard creates a bootable image to
write to a CD on any computer that contains a CD writer.
■ For CD media, third-party CD writing software is required if the protected
computer does not have a CD writer. The software is also required if the IDR
Preparation Wizard cannot detect the CD writer that is attached to the
protected computer. The CD hardware and software must be able to write
ISO 9660 CD images.
■ With both diskettes and CDs, prepare separate media for each operating
system level and language being protected.
Note: Windows XP and Windows Server 2003 do not support bootable diskettes.
Windows 2000 computers. However, you have to create a different diskette 1 for
each computer protected with IDR.
Diskette 1 contains a file named winnt.sif. It is the script used to automate
the installation of Windows 2000 for disaster recovery. This scripted
installation of Windows 2000 requires that the name of the computer being
recovered be listed in the winnt.sif file.
Therefore, for each Windows 2000 computer that shares diskettes 2 through 5,
make a copy of diskette 1 (and its files). For each copy of diskette 1, edit the
winnt.sif file and change the computer name to the name of the computer to
be protected. If you do not change the computer name, duplicate computer
names on the network may occur. The duplicate names may prevent the
recovered computer from participating on the network.
image to a CD using the IDR Preparation Wizard or other writing software. The
computer where you run the IDR Preparation Wizard may not have a CD-R or
CD-RW drive. If it does not, write the image onto a CD on a different computer
The CD image contains all the necessary IDR files unless you choose to store the
store them on the CD, the ASR files always are read from the CD even if more
recent versions are on a diskette. For example, suppose you create a bootable CD
and then later create IDR diskettes. During recovery, the ASR files are read from
the CD even though the IDR diskettes contain more recent versions.
The license key for your Windows 2000, Windows XP, or Windows Server 2003
operating system is required. If you do not enter the license key while creating
Note: On Windows NT 4.0 computers, the IDR software cannot write to a CD;
therefore, you must use other CD writing software to create the CD.
3 Select Create - Bootable CD Image for Use with CD Writers (ISO 9660) and
click Next.
The Starting CD Image Creation screen appears.
4 Follow the prompts until the IDR Preparation Wizard is completed.
Caution: Test your bootable CD to ensure that your computer can boot from it.
(See “Step 1: Boot your computer” on page 262.)
2 Click Next to continue. The Create or Update IDR Boot Media screen
appears.
3 Select Create - IDR Diskettes Only (Includes ASR Files for XP/2003) and
click Next. The Creating the IDR Diskettes screen appears.
4 Follow the prompts until the IDR Preparation Wizard is completed.
Updating a bootable CD
You cannot update a bootable CD, you must create a new bootable CD image and
then burn a new CD. If you install new hardware or change components on a
protected computer, create a new bootable CD.
For procedures, see “Creating a bootable CD image” on page 256.
Intelligent Disaster Recovery 259
Updating IDR media
3 Select Update - Full Set of Diskettes Used to Boot the Windows Installation
CD and click Next.
4 Follow the prompts until the IDR Preparation Wizard is completed.
260 Intelligent Disaster Recovery
Updating IDR media
Preparation Wizard.
To update the DR file only, run the drfile.exe file from a command prompt to
page 260.
3 Select IDR Diskettes Only (Includes ASR Files for XP/2003) and click Next.
4 Follow the prompts until the IDR Preparation Wizard is completed.
contains the DR file. The name of the DR file should match the computer name
of the client (the name that IDR requires). The name is required, even if it differs
from the name that is used in the NetBackup policy configuration.
1 Go to install_path\NetBackup\bin and double-click drfile.exe.
The drfile.exe program creates (or updates) the DR file that is located in
the install_path\NetBackup\Idr\Data directory on your computer.
2 If the NetBackup client name is different than the computer name, rename
the DR file.
The DR file name is in the form computer_name.dr. The name of the DR
file must match the computer name of the client. If the NetBackup client
name is different than the computer name, you must rename the DR file so
it can be used in a recovery.
3 Insert the diskette that contains the DR file and copy the DR file to it.
The diskette can be one of the IDR diskettes or a separate diskette. If you
use a separate diskette, insert the separate diskette when prompted for the
DR file during disaster recovery.
Note: Windows 2000: if Let IDR Automatically Partition the Boot and System
Drives was not selected during IDR preparation,reinstall any utility partitions
before the recovery process begins. Reinstall the partitions by using the
OEM-supplied installation program. During recovery, select the option to
partition and format the drives manually.
Caution: Disconnect any storage area network or cluster computers that are
attached to the computer being recovered. If they are not disconnected, the hard
drives on those computers may be partitioned and formatted.
3 Follow the on-screen boot process instructions and continue with “Step 2:
Note: If a DR file does not exist, click Next to proceed. When the wizard
notifies you that you did not select a recovery file, click Yes to continue in
manual mode.
2 One or more screens about hard disk layout may appear, as follows:
■ Whether to replace the current hard drive partition with the partition
information contained in the DR file or to keep the current hard drive
partitions.
■ Run the Windows Disk Administrator (or Disk Manager) program. The
program lets you make additional changes to the partition information.
To make partition changes, click Run Disk Administrator or Run Disk
Manager.
For more information, see “Notes on altering hard drive partition
sizes” on page 267.
Otherwise, click Next to continue the recovery process.
For more information about Disk Administrator and fault tolerant
configurations, see the operating system documentation.
3 For Windows 2000, a Completed IDR Phase 1 dialog box appears. Perform
one of the following actions:
■ If your network adapter requires special driver software, click
Pre-install Custom Network Driver. Follow the prompts to find and
install the appropriate driver software. Special drivers are the drivers
that are not on the operating system installation program. For
example, a driver for a network interface card (NIC) supplied by the
manufacturer.
■ To continue, click Next and go to step 5 to continue the recovery.
Intelligent Disaster Recovery 265
Recovering your computer
4 For Windows NT only, you are asked to select either Automatic Restore or
Manual Restore for network installation. Perform one of the following
actions:
■ If your network adapters use the drivers and the software that is
included with the operating system, select Automatic Restore. Click
Finish to complete the network installation. Proceed to step 5 to
continue the recovery.
■ If your network adapters require special drivers and software, select
Manual Restore. Select Wired to the Network and click Next. Proceed
to step a.
a To select the network adapter, perform one of the following actions:
■ Click Select from list if the network adapter requires a
manufacturer-supplied setup diskette. Then click Have Disk.
■ If the network adapter does not require a manufacturer-supplied
setup diskette, click either Select from list or Start search.
A list of network adapters appears.
Note: If your network adapter is not listed, click Select from list. Then click
Have Disk add an adapter to the Network Adapter List. For automatic
network installation to succeed, the Windows NT installation program must
be able to recognize the network interface card being used.
b The next screen lists the default network protocols. Select the
networking protocols that are used on the network. Click Next.
c Windows NT is ready to install the networking components. Insert the
Windows NT installation CD or the IDR bootable CD into the CD-ROM
drive. Click Next to continue. (If you created a bootable CD, it may
include the appropriate network drivers if the drive were found during
the IDR preparation process.)
%SYSTEMROOT%\System32\VERITAS\NetBackup\Bin
-----------------------------------------
SYSVOL Restore: Primary
-----------------------------------------
SYSVOL Restore: Primary
Hard Link Restore: Perform secondary restore
Same Hardware Restore: Assume same hardware
Intelligent Disaster Recovery 267
Notes on recovering specific platforms
Note: This section applies only to Windows NT and Windows NT 4.0. Formatting
and partitioning is not supported on Windows 2000, Windows XP, or Windows
Server 2003.
IDR defaults to restore hard drive partitions to their pre-recovery size. The
recovery computer may contain a larger hard drive than before the recovery.
For example, a larger hard drive may have been installed or the DR file may be
from a computer with a smaller hard drive. There may be unused and
unallocated hard drive space. Run the Windows NT Disk Administrator program
to alter the partition sizes to match the larger hard drive size. The Windows NT
Disk Administrator program is accessible during the IDR recovery process
within the Recovery Wizard. For information about fault tolerant
configurations, please refer to the Windows NT Server 4.0 Resource Kit.
Note: This section discusses how to restore a Dell computer. The general
procedure is the same for any computer that requires the use of third-party
drivers.
To load Windows on this type of computer, you must load the PowerRaid II
driver manually, which is not bundled with the Windows operating system.
Load the Adaptec controller driver manually after loading the PowerRaid II
Use the following steps with your IDR recovery diskette set
1 When the Windows blue Setup screen appears after booting with the IDR
boot diskette, press and hold down the F6 key.
2 Windows prompts for IDR diskette 2.
3 Insert IDR diskette 2 and press and hold the F6 key again.
After the additional drivers are loaded, a Setup screen appears that lets you
specify additional devices.
4 Release the F6 key and press the S key.
5 Follow the on-screen instructions to load the PowerEdge RAID II controller
software.
6 After the PowerEdge RAID software is loaded, press S again to specify
loading another device.
7 Follow the on-screen instructions to load the Adaptec controller software
next.
8 After both pieces of third-party software are loaded, press Enter and
proceed as normal to recover the computer.
A. No, because boot managers usually are installed at a very low level that
For example, the OS/2 boot manager resides in its own hard drive partition that
NetBackup cannot access. Because of the many different boot managers on the
unbootable even though the operating system has been restored. In this case,
Q. I ran a full backup of my computer but when I run the IDR Preparation
Q. Why does the recovery wizard warn me that one or more of my hard drives
A. The minimal version of Windows that runs the recovery wizard may have
Other types of mass storage controllers are usually seen as SCSI controllers by Windows.
Note: Windows NT: If the IDR Recovery Wizard does not detect the hard drive
order, set up hard drive partitions manually. To do so, use the Windows NT Disk
Administrator option within the Disaster Recovery Wizard. Then, continue with
the automated restore of the backup media.
If the recovery wizard reports drives greater than 8 GBs as being only 8 GBs,
create bootable diskettes. To do so, enable the Use SCSI drivers currently
installed on this computer option.
Index
AUTHORIZATION_SERVICE 34
access control
AVRD_SCAN_DELAY, vm.conf entry 89
to a server or client 79
B
ACS_ vm.conf entry 83
backups
bpend_notify script
bpstart_notify script
compressed 162
ALLOW_MEDIA_OVERWRITE 32, 69
ALLOW_MULTIPLE_RETENTIONS_PER_MEDIA 3
3, 70
multiplexed 162
ALLOW_NON_RESERVED_PORTS 33
client 67
booting a computer
directives 242
installing 241
options 32
restores 244
personal
troubleshooting 246
personal file
272
bpadm, using
modifying
clients
bp.conf 106
information 122
C
Global properties, specifying 123
catalog backups
information 123
changing
NetBackup-database backup
character device 148
manual 130
checkpoint restart
utility 118
tape 139
BPARCHIVE_POLICY 68
times allowed 197
BPARCHIVE_SCHED 68
CLIENT_CONNECT_TIMEOUT 41
BPBACKUP_POLICY 68
CLIENT_NAME 70
BPBACKUP_SCHED 69
CLIENT_PORT_WINDOW 41, 71
BPBRM_VERBOSE 35
CLIENT_PORT_WINDOW, vm.conf entry 89
BPDBJOBS_COLDEFS 36
CLIENT_READ_TIMEOUT 41, 42, 71
BPDBM_VERBOSE 38
CLIENT_RESERVED_PORT_WINDOW 43, 71
bpdynamicclient 103
clients
bpend_notify script
bp.conf options 31
BPEND_TIMEOUT 40
IGNORE_XATTR bp.conf entry 76
BPRD_VERBOSE 39
IGNORE_XATTR_SOLARIS bp.conf entry 76
bpstart_notify script
cluster environments 90, 217
BPSTART_TIMEOUT 41
COMPRESS_SUFFIX 71
BPTM_VERBOSE 39
CONNECT_OPTIONS 43
BUSY_FILE_NOTIFY_USER 70
control path, robotic 144
busy-file processing
crawlreleasebyname, vmoprcmd option 215
CRYPT_KEYFILE 74
273
CRYPT_LIBPATH 74
name 149
CRYPT_STRENGTH 73
no rewind device 148
D stand-alone 149
DEFAULT_CONNECT_OPTIONS 45
delays 167
EMM_REQUEST_TIMOUT, vm.conf entry 92
discovery 228
EMM_RETRY_COUNT, vm.conf entry 92
DHCP server 99
ENABLE_ROBOT_AUTH, vm.conf entry 92
DISABLE_JOB_LOGGING 46
encryption 164
DISABLE_STANDALONE_DRIVE_EXTENSIONS 46
English error log 49, 75
DISALLOW_BACKUPS_SPANNING_MEDIA 46
extended attribute files 162
DISALLOW_CLIENT_LIST_RESTORE 47
to ignore during backup 76
DISALLOW_CLIENT_RESTORE 47
ExTeNt.nnnn files 165
DISALLOW_SERVER_FILE_WRITES 75
disaster recovery
F
procedure 261
FAILOVER_RESTORE_MEDIA_SERVERS 48
DO_NOT_RESET_FILE_ACCESS_TIME 75
@@MaNgLeD.nnnn_Rename 165
drives
positioning on tape 237
adding 148
format
cleaning
optical media 143
manual 196
fragmented backups 225
operator-initiated 196
frequency-based drive cleaning 196
overview 194
configuring 144
deleting 150
274
GENERATE_ENGLISH_LOGS 49, 75
H Windows
host names
disk administrator 264
short 160
INVENTORY_FILTER, vm.conf entry 92, 93
K
I
KEEP_DATABASE_COMM_FILE 76
IBM
KEEP_LOGS_DAYS 76
INCOMPLETE_JOB_CLEAN_INTERVAL 50
LIMIT_BANDWIDTH 50
INFORMIX_HOME 76
LIST_FILES_TIMEOUT 77
INITIAL_BROWSE_SEARCH_LIMIT 50
LOCKED_FILE_ACTION 77
Logging
host properties
bootable media
preparing 252
configuration 251
diskettes
preparing 252
M
updating 259
mail notifications, USEMAIL on UNIX clients 81
DR files
manual backups, with bpadm 125, 126
overview 250
MAP_ID, vm.conf entry 93
overview 250
host properties
275
configuring 132
NBRB_REEVAL_PERIOD 56
formats 223
NDMP 162, 217
pool 197
NetBackup Access Control (NBAC)
server register 29
NetBackup for Informix 76
Media Manager
notification scripts 172
configuration file 82
security 97
O
Media request delay property 54
online help for tpconfig 147
MEDIA_ID_PREFIX 53
format 224
MEDIA_REQUEST_DELAY 54
usage 238
MEDIA_SERVER 54, 77
OS/2, boot manager and IDR 269
MEDIA_UNMOUNT_DELAY 54
Overwrite existing files property 62
MEGABYTES_OF_MEMORY 78
Overwrite existing files restore option 63
move volumes
P
multiple volumes 137
peername, client 159
MPX_RESTORE_DELAY 54
positioning tape files 237
multiple servers 24
PREFERRED_GROUP, vm.conf entry 96
multiplexing (MPX)
PREVENT_MEDIA_REMOVAL, vm.conf entry 96
backups 225
printing device configuration 153
demultiplexing 23
MUST_USE_LOCAL_DRIVE 55
RE_READ_INTERVAL 57
VxFS 162
regular expressions, AFS file list 243
NBRB_CLEANUP_OBSOLETE_DBINFO 55
remove a server from a configuration 208
NBRB_ENABLE_OPTIMIZATIONS 55
REMOVE_BACKUP_VOLUMES 243
NBRB_FORCE_FULL_EVAL 55
removing tape files 237
NBRB_MPX_GROUP_UNLOAD_DELAY 56
replacing a device in a shared drive
NBRB_REEVAL_PENDING 56
276
configuration 206
restore_notify 172
requests
session_notify 172
REQUIRED_INTERFACE 57, 59
userreq_notify 172
set on client 79
SCSI persistent reserve 211
RESTORE_RETRIES 78
limitations 217, 218
restores
overview 212
retrying 78
SERVER 54
rewind
bp.conf option on client 79
robots
server, NetBackup
adding 147
controlling access 79
configuring 144
SERVER, vm.conf entry 97
deleting 151
SERVER_PORT_WINDOW 61, 79
drive 149
servers
type 148
NetBackup
Robust logging 48
master 25
media 25
multiple 24
schedules
session_start_notify script 187
scripts
extended attributes 162
available_media 171
spanning media 221, 222, 225
backup_exit_notify 172
SSO, vm.conf entries 98
backup_notify 172
SSO_DA_REREGISTER_INTERVAL, vm.conf
bpend_notify 172
entry 98
dbbackup_notify 172
SSO_HOST_NAME, vm.conf entry 98
diskfull_notify 172
stand-alone drive
drive_mount_notify 236
extensions, disabling 222
drive_unmount_notify 238
tpconfig 149
notification 172
subnets, address formats 51
parent_end_notify 172
SYBASE_HOME 80
parent_start_notify 172
277
Authorization
overview 144
AUTHENTICATION_DOMAIN 33
printing device configuration 153
AUTHORIZATION_SERVICE 34
starting 146
tape
tpunmount, removing tape files 237
tape format
fragmented 225
U
multiplexed 225
UNLINK_ON_OVERWRITE 63
non-QIC 224
USE_CTIME_FOR_INCREMENTALS 80
QIC/WORM 224
USE_FILE_CHG_LOG 80
requirements 191
access to devices 239
density 236
userreq_notify script 187
rewinding 237
VERBOSE, vm.conf entry 99
tar
VXSS_NETWORK bp.conf entry 81
GNU 162
vm.conf file
time zones
ACS_CSI_HOSTPORT entries 83
timeout
ACS_SSI_INET_PORT entries 84
bpend 40
ACS_SSI_SOCKET entries 85
tpconfig
API_BARCODE_RULES entries 87
menus 146
CLEAN_REQUEST_TIMEOUT entries 89
278
W
wildcard characters