6.5 admin guide 2 (unix)

Veritas NetBackup Administrators Guide, Volume IIfor UNIX and Linux

Release 6.5

12308278

Veritas NetBackup Administrators Guide, Volume IICopyright 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. THIS DOCUMENTATION IS PROVIDED AS IS AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NONINFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID, SYMANTEC CORPORATION SHALL NOT BE LIABLE FOR INCIDENTAL OR CONSEQUENTIAL DAMAGES IN CONNECTION WITH THE FURNISHING, PERFORMANCE, OR USE OF THIS DOCUMENTATION. THE INFORMATION CONTAINED IN THIS DOCUMENTATION IS SUBJECT TO CHANGE WITHOUT NOTICE. The Licensed Software and Documentation are deemed to be commercial computer software and commercial computer software documentation as defined in FAR Sections 12.212 and DFARS Section 227.7202. Symantec Corporation 20330 Stevens Creek Blvd. Cupertino, CA 95014 www.symantec.com Printed in the United States of America.

Third-party legal noticesThird-party software may be recommended, distributed, embedded, or bundled with this Veritas product. Such third-party software is licensed separately by its copyright holder. All third-party copyrights associated with this product are listed in the accompanying release notes.

Licensing and registrationVeritas NetBackup is a licensed product. See the NetBackup Installation Guide for license installation instructions.

Technical supportFor 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

Chapter 1

Additional configurationMultiplexing .........................................................................................................17 When to use multiplexing ...........................................................................18 How to configure multiplexing ..................................................................18 Maximum streams per drive for a storage unit ...............................19 Media multiplexing for a schedule ....................................................19 Other configuration settings to consider using multiplexing ......22 Demultiplexing .............................................................................................23 Using multiple NetBackup master servers ......................................................24 Using multiple media servers with one master server ..................................25 Software on each server ..............................................................................26 NetBackup catalogs .....................................................................................27 Adding a media server .........................................................................................27 Registering a media server .........................................................................29 NetBackup configuration options .....................................................................31 Syntax rules for bp.conf options ...............................................................31 bp.conf options for servers .........................................................................32 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

6

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 bp.conf options for UNIX clients ............................................................... 66 ALLOW_NON_RESERVED_PORTS ................................................... 67 AUTHENTICATION_DOMAIN ........................................................... 67 BPARCHIVE_POLICY ........................................................................... 68

7

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

8

UNIX client examples .................................................................................. 82 Example /usr/openv/netbackup/bp.conf file .................................. 82 Example $HOME/bp.conf file ............................................................ 82 vm.conf options for media servers ........................................................... 82 ACS_mediatype ......................................................................................83 ACS_SEL_SOCKET ............................................................................... 83 ACS_CSI_HOSTPORT .......................................................................... 83 ACS_SSI_HOSTNAME ......................................................................... 84 ACS_SSI_INET_PORT .......................................................................... 84 ACS_SSI_SOCKET ................................................................................ 85 ACS_TCP_RPCSERVICE / ACS_UDP_RPCSERVICE ........................ 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

9

TLM_mediatype ....................................................................................99 VERBOSE ...............................................................................................99 Example vm.conf file ...........................................................................99 Dynamic host name and IP addressing ............................................................99 Setting up dynamic IP addresses and host names ................................101 Configuring the NetBackup master server ............................................102 Configuring a dynamic Microsoft Windows client ...............................103 Configuring a dynamic UNIX NetBackup client ....................................103 Busy file processing (UNIX clients only) ........................................................105 Getting started ...........................................................................................106 Modifying bp.conf to configure busy file processing ...........................106 BUSY_FILE_PROCESSING ................................................................106 BUSY_FILE_DIRECTORY ..................................................................107 BUSY_FILE_ACTION .........................................................................107 Creating action files ...................................................................................108 Logs directory .............................................................................................109 Modifying bpend_notify_busy .................................................................110 Configuring email notifications ......................................................................111 Specifying the locale of the NetBackup installation ....................................112 Adjusting time zones in the NetBackup-Java console ..................................113

Chapter 2

Menu user interfacesUsing the bpadm NetBackup management utility ........................................118 Data classification management .............................................................118 Defining and managing storage units and storage unit groups .........119 Defining and managing storage unit groups .................................119 Defining and managing policies ..............................................................120 Configuring an online catalog backup ............................................120 Defining NetBackup global attributes ....................................................123 Defining and managing Fibre Channel transport .................................124 Displaying reports .....................................................................................124 Performing manual backups ....................................................................125 Performing special actions .......................................................................126 Install NetBackup on all trusting clients ........................................126 Perform an offline catalog backup ..................................................126 Modifying offline catalog backup settings .....................................127 Performing manual offline catalog backups ..................................130 Redefining retention levels ..............................................................131 Defining and managing server groups ...................................................132 Using the vmadm media management utility ...............................................132 Starting vmadm ..........................................................................................132 Starting and stopping vmd .......................................................................133 The vmadm main menu ............................................................................133

10

Defining and managing volume pools .................................................... 134 Adding volumes ......................................................................................... 134 Auto-populating a robot ................................................................... 135 Displaying the volume configuration ..................................................... 136 Deleting volumes or groups ..................................................................... 136 Moving volumes or a volume group ........................................................ 136 Moving volumes or volume groups ................................................. 137 Changing a volume description ............................................................... 137 Changing a volume's volume pool ...........................................................137 Changing the expiration date for volumes ............................................ 138 Changing the volume group for volumes ............................................... 138 Change Vault attributes of volumes ....................................................... 138 Setting the maximum mounts for volumes ........................................... 139 Modifying the number of cleanings ........................................................ 139 Updating barcodes for selected volumes in a robot ............................. 140 Inventory robots ........................................................................................ 140 Inventory a robot ...............................................................................140 Configuring barcode rules ........................................................................ 143 Formatting optical disks ........................................................................... 143 Using the tpconfig device configuration utility ............................................ 144 Robot number ..................................................................................... 144 Robotic control path .......................................................................... 144 Host name ........................................................................................... 145 No rewind on close device name ...................................................... 145 Character device name ...................................................................... 145 Volume header device name ............................................................ 145 Drive status ......................................................................................... 146 Starting the tpconfig device configuration utility ............................... 146 Adding robots ............................................................................................. 147 Adding drives ............................................................................................. 148 Updating a robot configuration ............................................................... 149 Updating a drive configuration ............................................................... 150 Deleting a drive .......................................................................................... 150 Deleting a robot .......................................................................................... 151 Configuring drive paths ............................................................................ 151 Configuring host credentials ................................................................... 152 Displaying and printing your device configuration ............................. 153 Using the disk configuration utility ............................................................... 153 Managing SharedDisk ...............................................................................154 Managing OpenStorage ............................................................................ 154

Chapter 3

Reference topicsRules for using host names in NetBackup ..................................................... 158

11

Qualifying host names ..............................................................................158 How NetBackup uses host names ............................................................158 Server and client name on UNIX servers and clients ...................158 Host names on Windows servers and PC clients ...........................159 Policy configuration ..........................................................................159 Image catalog ......................................................................................159 Error catalog .......................................................................................160 Catalog backup information .............................................................160 How to update NetBackup after a host name changes .........................160 Special considerations for Domain Name Service (DNS) .....................161 Reading backup images with tar .....................................................................162 Effects of a non-NetBackup tar ........................................................162 Files that tar generates .....................................................................165 Factors that affect backup time .......................................................................165 Total data ....................................................................................................166 Transfer rate ...............................................................................................166 Compression ...............................................................................................167 Device delays ..............................................................................................167 Determining NetBackup transfer rate ............................................................167 Network transfer rate ................................................................................167 Network transfer plus end-of-backup-processing rate ........................167 Total transfer rate .....................................................................................168 Examples .....................................................................................................168 How NetBackup builds a worklist ....................................................................169 Building the worklist (Queue) ..................................................................169 To prioritize queued jobs ..........................................................................170 Determining backup media requirements .....................................................171 NetBackup notify scripts ..................................................................................172 backup_notify .....................................................................................173 backup_exit_notify ............................................................................173 bpstart_notify (UNIX clients only) ..................................................174 bpstart_notify.bat (Microsoft Windows clients only) ..................176 bpend_notify (UNIX clients only) ....................................................178 bpend_notify.bat (Microsoft Windows clients only) ....................180 bpend_notify_busy (UNIX clients only) ..........................................183 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

userreq_notify .................................................................................... 187 Media and device management best practices .............................................. 187 General practices ....................................................................................... 188 Media management ................................................................................... 188 Device management .................................................................................. 189 Performance and troubleshooting ..........................................................190 Using TapeAlert .................................................................................................190 Requirements for using TapeAlert .........................................................191 TapeAlert log codes ................................................................................... 191 Drive cleaning overview ................................................................................... 194 Reactive cleaning (TapeAlert) .................................................................. 194 TapeAlert cleaning ............................................................................ 195 TapeAlert and frequency-based cleaning ......................................195 Library-based cleaning .............................................................................195 Frequency-based cleaning ........................................................................ 196 Frequency-based cleaning limitations ........................................... 196 Operator-initiated cleaning ..................................................................... 196 Using a cleaning tape ................................................................................ 197 Volume pool and volume group overview ..................................................... 197 Volume pools .............................................................................................. 198 Volume groups ........................................................................................... 198 Rules for assigning volume groups ................................................. 198 Volume pool and volume group example ............................................... 199 Scratch volume pools ................................................................................ 200 Scratch pool example ........................................................................ 200 Scratch pool usage .............................................................................201 Barcode overview ............................................................................................... 202 Barcode advantages ................................................................................... 202 Barcode best practices ..............................................................................202 Barcode rules .............................................................................................. 203 NetBackup actions for barcodes ...................................................... 203 Checking barcodes .............................................................................204 Example barcode rules ...................................................................... 204 Media ID generation rules ........................................................................ 206 Changing your hardware configuration .........................................................206 Replacing devices ....................................................................................... 206 Decommissioning a media server ...........................................................208 How NetBackup selects drives ......................................................................... 210 How NetBackup reserves drives ...................................................................... 211 SCSI persistent reserve process .............................................................. 212 SCSI persistent reserve commands ................................................. 213 SCSI persistent reserve conflicts ..................................................... 213 SPC-2 SCSI reserve process ...................................................................... 213

13

SPC-2 SCSI reserve commands ........................................................214 SCSI reservation conflicts ................................................................215 Forcing a release ................................................................................215 Breaking a reservation ......................................................................216 SCSI reserve requirements and limitations ...........................................216 SCSI reservation logging ..........................................................................217 Server operating system limitations ......................................................218 Checking for data loss ...............................................................................218 Possible data loss causes ...................................................................218 Checking for tape and driver configuration errors ..............................218 Common configuration problems ....................................................219 Configuring SCSI reserve ..........................................................................219 How NetBackup selects media .........................................................................219 Selecting media in robots .........................................................................220 Spanning media ..................................................................................221 Selecting media in stand-alone drives ....................................................221 Media selection using stand-alone drive extensions ....................221 Media formats ....................................................................................................223 Standard tape format ................................................................................224 QIC/WORM tape format ............................................................................224 Optical media format .................................................................................224 Fragmented backups .................................................................................225 Multiplexing format ..................................................................................225 Spanning tapes ...........................................................................................225 Media Manager commands ..............................................................................226 Device discovery overview ...............................................................................228 Device serialization ...................................................................................228 Devices that can be discovered ................................................................229 Device discovery in NetBackup ................................................................229 Device discovery in the Device Configuration Wizard .........................230 Device discovery and shared tape drives ...............................................230 Viewing and verifying the device configuration ...................................231 Adding devices without discovery ...........................................................231 Device mapping file ...................................................................................231 Correlating tape drives to device files or addresses .....................................232 Correlating devices and device files on UNIX hosts .............................232 Correlating devices and names on Windows hosts ..............................233 Tape I/O commands ...........................................................................................235 Requesting tapes ........................................................................................235 drive_mount_notify script ................................................................236 tpreq example .....................................................................................236 Reading and writing tape files .................................................................237 Positioning tape files .........................................................................237

14

Rewinding tape files .......................................................................... 237 Removing tape files ................................................................................... 237 drive_unmount_notify script ...........................................................238 Using an optical disk ................................................................................. 238 External access to Media Manager controlled devices ........................ 239 User error messages .................................................................................. 240

Chapter 4

Using NetBackup with AFSInstallation ......................................................................................................... 241 System requirements ................................................................................ 241 Server and client installation .................................................................. 241 Configuration ..................................................................................................... 241 General policy attributes .......................................................................... 242 Client list ..................................................................................................... 242 Backup selections ...................................................................................... 242 Backup selection list directives ............................................................... 242 Regular expressions .................................................................................. 243 Exclude and include lists .......................................................................... 244 Backups and restores ........................................................................................ 244 Backups ....................................................................................................... 244 Automatic backup ..............................................................................244 Manual backup ................................................................................... 244 Restores ....................................................................................................... 244 Restore from the NetBackup for AFS client .................................. 244 Restore from the NetBackup master server .................................. 245 Notes about restores .......................................................................... 245 Troubleshooting .................................................................................................246 Troubleshooting backups ......................................................................... 246 Troubleshooting restores ......................................................................... 246

Chapter 5

Intelligent Disaster RecoveryChanges for NetBackup 6.0 and later ............................................................. 248 Supported Windows editions ........................................................................... 248 Requirements for IDR ....................................................................................... 249 Overview of IDR use .......................................................................................... 250 About the DR files .............................................................................................. 250 Configuring NetBackup policies for IDR ........................................................ 251 Backing up the protected computer ................................................................ 252 Creating IDR media ........................................................................................... 252 Choosing the bootable media ................................................................... 253 Creating bootable diskettes ...................................................................... 254 To modify diskette sets for use with multiple Windows 2000 computers

15

255 Creating a bootable CD image ..................................................................256 Creating IDR diskettes ..............................................................................257 Updating IDR media ..........................................................................................258 Updating a bootable CD ............................................................................258 Updating bootable diskettes .....................................................................259 Updating IDR diskettes only ....................................................................260 Using drfile.exe to create or update a DR file ........................................260 Recovering your computer ...............................................................................261 Step 1: Boot your computer ......................................................................262 Step 2: Windows setup in IDR recovery .................................................263 Step 3: Disaster recovery wizard .............................................................264 Notes on altering hard drive partition sizes ..........................................267 Notes on recovering specific platforms ..........................................................267 Recovering the dell PowerEdge 6100/200 with RAID ..........................268 Recovering IBM computers ......................................................................268 Recovering Compaq computers ...............................................................269 IDR frequently asked questions ......................................................................269

Index

271

16

Chapter

1

Additional configurationThis chapter explains settings that, in most instances, are optional. The sections in this chapter include the following:

Multiplexing on page 17 Using multiple NetBackup master servers on page 24 Using multiple media servers with one master server on page 25 Adding a media server on page 27 NetBackup configuration options on page 31 Dynamic host name and IP addressing on page 99 Busy file processing (UNIX clients only) on page 105 Configuring email notifications on page 111 Specifying the locale of the NetBackup installation on page 112 Adjusting time zones in the NetBackup-Java console on page 113

MultiplexingNetBackup 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

No special action is required to restore a multiplexed backup. NetBackup finds the media and restores the requested backup.Clients

Disk

Server Removable media or magnetic disk

Disk

Disk

When to use multiplexingMultiplexing is generally used to reduce the amount of time that is required to complete backups. The performance in the following situations would be improved by using multiplexing:

Slow clients. Instances in which NetBackup uses software compression, which normally reduces client performance, are also improved. Multiple slow networks. The parallel data streams take advantage of whatever network capacity is available. Many short backups (for example, incremental backups). In addition to providing parallel data streams, multiplexing reduces the time each job waits for a device to become available. Therefore, the storage device transfer rate is maximized.

Multiplexing reduces performance on restores because it uses extra time to read the images. 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.

How to configure multiplexingMultiplexing must be set in two places in the NetBackup configuration:

Additional configuration Multiplexing

19

Storage unit Schedule

Note: If you change these values, it does not take effect until the next time a schedule runs.

Maximum streams per drive for a storage unitThe Maximum Streams Per Drive setting for a storage unit specifies how many backups NetBackup can multiplex onto any single drive in the storage unit. The value is set for each storage unit. For more information, see Enable multiplexing on page 230 in the NetBackup Administrators Guide, Volume I. 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 on the central processing unit:

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.

Media multiplexing for a scheduleIn addition to the Maximum Streams Per Drive setting for a storage unit, specify a Media Multiplexing value for each schedule. For more information, see Media multiplexing on page 141 in the NetBackup Administrators Guide, Volume I. The Media Multiplexing value specifies the maximum number of backups from the schedule to be multiplexed onto any single drive in the configuration. The Media Multiplexing setting ranges from 1 through 32, where 1 is the default and specifies no multiplexing. Regardless of the setting on a schedule, the 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 specific drives, other drives are available for non-multiplexed jobs.


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 schedules 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 units 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.


21

Figure 1-1Schedule A Media Multiplexing per drive = 2 dog 1 2 9 10

Multiplexing and schedulesStorage Unit Max mpx per drive = 4 A1 A2 A5 13 Drive 1 B2 6 B1 Schedule B Media Multiplexing per drive = 4 fox 5 12

cat 3 11 A3 Drive 2 4 A4 B4 8 B3 7

otter

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. 1 3 5 7 2 4 6 8 Jobs A1 and A2 from client dog start on drive 1. Schedule A Media Multiplexing limit of 2 is reached for this drive. Jobs A3 and A4 from client cat start on drive 2. Schedule A Media Multiplexing limit of 2 is reached for this drive. 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. 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 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.

13


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

Other configuration settings to consider using multiplexingLimit jobs per policySet Limit Jobs Per Policy high enough to support the specified level of multiplexing. For more information, see Limit jobs per policy on page 97 in the NetBackup Administrators Guide, Volume I.

Maximum jobs per clientThe Maximum Jobs Per Client property limits the number of backup jobs that can run concurrently on any NetBackup client. Usually, the client setting does not affect multiplexing. However, consider a case where jobs from different schedules on the same client go to the same storage unit. In this case, the maximum number of jobs that are permitted on the client would be reached before the multiplexing limit is reached for the storage unit. When the maximum number of jobs on the client is reached, it prevents NetBackup from fully using the storage units multiplexing capabilities. Maximum Jobs Per Client appears on the Global properties dialog box.

Maximum jobs this clientYou can also set the maximum number of jobs that are allowed on a specific client without affecting other clients. For more information, see Maximum data streams on page 387 in the NetBackup Administrators Guide, Volume I.

MPX restore delayThe Delay On Multiplexed Restores property applies to multiplexed restores. The property specifies how long the server waits for additional restore requests of files and raw partitions in a set of multiplexed images on the same tape. Delay On Multiplexed Restores appears on the General Server properties dialog box.


23

DemultiplexingDemultiplexing 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. Note: If you use the bpduplicate command instead of the NetBackup Administration Console, do not include the -mpx option on that command.

24 Additional configuration Using multiple NetBackup master servers

Using multiple NetBackup master servers

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 Mass Storage NetBackup Master Server A Workstations

Network A2

Mass Storage Network B1 Workstations Router Workstations Network B2

NetBackup Master Server B

Additional configuration Using multiple media servers with one master server

25

Using multiple media servers with one master serverYou can set up a NetBackup protection domain as follows:

One master server, which controls all backup scheduling. Multiple media servers, which write the backup images to disk or removable media. They may have peripheral devices to provide additional storage. Multiple protected NetBackup clients, which send their data to the media servers.

A protection domain refers collectively to the NetBackup master server, its NetBackup media servers, and its NetBackup clients. In a group of NetBackup servers, a client can have backups directed to any device on any server in the group. A common alternative strategy is to install extra peripherals on the clients that produce large amounts of data. The master server directs the data from the client to the clients peripherals, which reduces network traffic because the data does not traverse the network. This strategy also distributes the backup load between the master and the media servers. Two important points to remember about master and media servers:

There can be only one master server in a group. A NetBackup master server is a media server for itself but cannot be a media server for another master server.

26 Additional configuration 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.

Administration Interface* User Interface (BAR)

Master Server NetBackup Catalogs Configuration files Image database User Interface (BAR)

NetBackup Client

Storage Device

Information in relational databases (about devices, volumes)

Administration Interface*

User Interface

User Interface (BAR)

Storage Device

NetBackup Media Server

NetBackup Media Server

Storage Device

Remote Admin Console*

Remote Admin Console*

* You can also use the Backup, Archive, and Restore user interface from a Windows client that has the Remote Administration Console installed.

Software on each serverApplies to NetBackup Enterprise Server only. Install NetBackup server software on each NetBackup server that has a peripheral that you want to include in a storage unit. The NetBackup installation program has choices for master and media server installation.

Additional configuration Adding a media server

27

NetBackup catalogsApplies 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.

Adding a media serverThe following section applies to NetBackup Enterprise Server only. Use the following procedure to add a media server to an existing NetBackup environment. 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. To add a media server 1 On the new media server host, attach the devices and install any software that is required to drive the storage devices. For help, see the vendors documentation. Prepare the device drivers on the new media server hosts operating system as explained in the NetBackup Device Configuration Guide. Add the new media server to the additional servers list of the master server and of the clients the new media server backs up. If the EMM server resides on a host other than the master server, add the new media server to the additional servers list on that host. If the new media server is part of a server group, add it to the additional servers list on all media servers in the group. 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.

2 3

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. Select Actions > Properties.

c

d e f g

Select the Servers properties. Click Add next to the Additional servers window and type the name of the new server. Click Add to add the server to the additional server list for all selected hosts. Click Close.

h Click OK. For more information, see Servers properties on page 465 in the NetBackup Administrators Guide, Volume I. 4 5 6 7 8 9 Restart the NetBackup services on the master server, the EMM server, and the media servers on which you added the new server name. On NetWare target clients, add the new media server name by using a SERVER entry in the bp.ini file. Install the NetBackup media server software as explained in the NetBackup Installation Guide. Configure the drives and robots as explained in Devices in the NetBackup Administrators Guide, Volume I. Configure the volumes as explained in Media in the NetBackup Administrators Guide, Volume I. On the master server, do the following to the NetBackup configuration:

Additional configuration Adding a media server

29

a b

Add storage units to the media server. Always specify the media server as the media server for the storage unit. 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. For more information, see Chapter 4, NetBackup Catalog on page 275 in the Administrators Guide, Volume I. Paths on a Windows media server: 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 Configure the NetBackup policies and schedules to use the storage units that are configured on the media server.

c

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.

Registering a media serverIf the EMM server is not running when you add a media server, the media server is not registered. You cannot discover, configure, and manage devices. You must register the media server with the EMM server. To register a media server 1 2 Start the EMM service on the EMM server. On the EMM server host, run the following command (use the host name of the media server):nbemmcmd -addhost -machinename hostname -machinetype media -masterserver server_name -operatingsystem os_type -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 NetBackup configuration options

31

NetBackup configuration options

NetBackup configuration options allow an administrator to customize NetBackup to meet specific site preferences and requirements. In most instances, the defaults provide good results. To change the defaults, do so according to the one of the following methods:

In the NetBackup Administration Console, navigate to the various properties by selecting NetBackup Management > Host Properties within Master Servers, Media Servers, or Clients. Configuration options are described in Chapter 7 of the NetBackup Administrators Guide, Volume I. 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.

On NetBackup UNIX servers and clients, use one of the following:

Use the bpgetconfig command to obtain a list of configuration entries. Then, use bpsetconfig to change the entries. The commands are described in the NetBackup Commands for UNIX and Linux. Enter the option in the bp.conf file as explained in this chapter. Most options can be entered in this way. Enter the option in the vm.conf file as explained in this chapter. The vm.conf file contains configuration entries for media and device management. Use the nbemmcmd command to modify some options as noted in this chapter or as described in NetBackup Commands for UNIX and Linux.

On clients, specify configuration options as explained in the Backup, Archive, and Restore Getting Started Guide for the client.

Syntax rules for bp.conf optionsUse the following syntax rules to create entries in bp.conf:

Use the # symbol to comment out lines Any number of spaces or tabs are allowed on either side of = signs Blank lines are allowed Any number of blanks or tabs are allowed at the start of a line

32 Additional configuration NetBackup configuration options

bp.conf options for serversThe bp.conf options for NetBackup UNIX servers are located in the following file:/usr/openv/netbackup/bp.conf

If a single UNIX system is running as both a client and a server, the /usr/openv/netbackup/bp.conf file contains both the server the and client options. Each nonroot user on a UNIX client can also have a personal bp.conf file in their home directory:$HOME/bp.conf

For information about client options, see bp.conf options for UNIX clients on page 66. Note: The SERVER option must be present in the /usr/openv/netbackup/bp.conf file on all NetBackup UNIX clients and servers. It is also the only required entry in these bp.conf files. 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. Applies to NetBackup Enterprise Server only. The SERVER entries must be the same on all servers in a master and a media server cluster. Symantec recommends (but does not require ) that all other entries also match on all servers. (The CLIENT_NAME entry is an exception.)

ALLOW_MEDIA_OVERWRITEThe ALLOW_MEDIA_OVERWRITE option overrides NetBackups overwrite protection for various media formats on removable media. Use this option by adding it to the /usr/openv/netbackup/bp.conf file on a UNIX master server. Or, set the Allow media overwrite property in the Media host properties. For more information, see Chapter 7 of the NetBackup Administrators Guide, Volume I. For example, to permit overwriting the cpio format, add the following on the master server (and media servers if applicable):

ALLOW_MEDIA_OVERWRITE = CPIO


33

ALLOW_MULTIPLE_RETENTIONS_PER_MEDIAThe 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 Administrators Guide, Volume I. By using the nbemmcmd command. (See NetBackup Commands for UNIX and Linux.)

ALLOW_NON_RESERVED_PORTSThe 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 Use this option by adding it to the /usr/openv/netbackup/bp.conf file on a UNIX master server. For use on a client, see ALLOW_NON_RESERVED_PORTS on page 33.

AUTHENTICATION_DOMAINThe AUTHENTICATION_DOMAIN entry defines a set of Symantec product authentication principals. A master server that uses Symantec product authentication and authorization must have at least one AUTHENTICATION_DOMAIN entry, and more than one can be specified. If a media server or client does not define an authentication domain, it uses the authentication domains of its master server. Use this option by adding it to the /usr/openv/netbackup/bp.conf file on a UNIX master server. Or, add a domain in the Authentication Domain tab of the Access Control host properties. For more information, see Chapter 7 of the NetBackup Administrators Guide, Volume I. AUTHENTICATION_DOMAIN = domain "comment" mechanism broker [ port ]


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.

ExampleAUTHENTICATION_DOMAIN = mycompany.com "Typical UNIX logins" NIS broker1.mycompany.com AUTHENTICATION_DOMAIN = OurEnterprise "Typical Windows logins" WINDOWS broker2.mycompany.com 5544 AUTHENTICATION_DOMAIN = mycompany.com "VxSS-Only Identities" VXPD broker1.mycompany.com AUTHENTICATION_DOMAIN = broker3.mycompany.com "Local UNIX Logins on host broker3" PASSWD broker3.mycompany.com

In the example, mycompany.com is the Internet domain name and OurEnterprise is the Windows domain name. The broker on host name broker1 handles both NIS and private authentication for Symantec product authentication. The broker on host name broker2 handles Windows authentication for Symantec product authentication. broker2 uses the non-standard port number 5544. The broker on host name broker3 uses its local /etc/passwd file for Symantec product authentication.

AUTHORIZATION_SERVICEThe 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


35

media server does not define an authorization service, it uses its master server's authorization service. Use this option by adding it to the /usr/openv/netbackup/bp.conf file on a UNIX master server. Or, enter a host name in the Authorization Service tab in the Access Control host properies. For more information, see Chapter 7 of the NetBackup Administrators Guide, Volume I.

AUTHORIZATION_SERVICE = host [ port ]

Where:

host is the host name or IP address of the authorization service. port is the port number of the authorization service. The default is the standard port number for the authorization service.

BPBRM_VERBOSEUsed 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 Administrators 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.


For more information about the bpbrm debug log, see the NetBackup Troubleshooting Guide for UNIX and Windows.

BPDBJOBS_COLDEFSAdd 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.

ExampleBPDBJOBS_COLDEFS BPDBJOBS_COLDEFS BPDBJOBS_COLDEFS BPDBJOBS_COLDEFS BPDBJOBS_COLDEFS BPDBJOBS_COLDEFS BPDBJOBS_COLDEFS BPDBJOBS_COLDEFS BPDBJOBS_COLDEFS = = = = = = = = = JOBID 5 true TYPE 4 true STATE 5 true STATUS 6 true POLICY 6 true SCHEDULE 8 true CLIENT 6 true DSTMEDIA_SERVER 12 true ACTPID 10 true

Note: Keep in mind the following ramifications of a BPDBJOBS_COLDEFS entry in the bp.conf conditions: The addition of any BPDBJOBS_COLDEFS entry overrides all default columns. All users on the local system see only those columns that are specified in the bp.conf file.


37

Table 1-1 COLDEFS EntryACTIVEELAPSED

BPDBJOBS_COLDEFS Entries and Column Head Names Column NameActive Elapsed (elapsed active time) Active PID (PID of job) Attempt Backup Type Client Completion (percent complete) Compression (yes or no) Dest Media Svr (writing media server) Dest Media ID (writing media ID) Dest StUnit (writing storage unit)

COLDEFS EntryPATHNAME

Column NameKB Per Sec

ACTPID ATTEMPT BACKUPTYPE CLIENT COMPLETION COMPRESSION

PARENTJOBID POLICY POLICYTYPE PRIORITY PROFILE RETENTION

Parent JobID Policy Policy Type Priority Profile (Vault only) Retention (retention period) Resumable

DSTMEDIA_SERVER

RESUMABLE

DSTMEDIAID

ROBOT

Robot (Vault only)

DSTSTORAGE_UNIT

RQSTPID

Request PID (PID requesting job, if applicable) Schedule Schedule Type Session ID (Vault only)

ELAPSED ENDED ESTFILE

Elapsed (elapsed time) Ended Est File (estimated number of files) Est KB (estimated number of kilobytes) Files Group JobID Pathname Kilobytes Last Backup (date and time)

SCHEDULE SCHEDULETYPE SESSIONID

ESTKB

SRCMEDIA_SERVER

Src Media Svr

FILES GROUP JOBID KBPERSEC KILOBYTES LASTBACKUP

SRCMEDIAID SRCSTORAGE_UNIT STARTED STATE STATUS STREAMNUMBER

Src Media ID Src StUnit Started State Status Stream Number


Table 1-1 COLDEFS EntryMAINPID

BPDBJOBS_COLDEFS Entries and Column Head Names (continued) Column NameMain PID (PID that spawns job, if applicable) Media to Eject (number of tapes to eject; Vault only) Operation (current operation) Owner

COLDEFS EntrySUSPENDABLE

Column NameSuspendable

NUMTAPESEJECT

TYPE

Type (job type)

OPERATION OWNER

VAULT

Vault (Vault only)

BPDBM_VERBOSEUsed for debugging purposes, the BPDBM_VERBOSE option controls the amount of information NetBackup includes in its bpdbm debug logs. Use this option by adding it to the /usr/openv/netbackup/bp.conf file on a UNIX master server. Or, set the BPDBM logging level property in the Logging host properties. For more information, see Chapter 7 of the NetBackup Administrators Guide, Volume I. Default: The same value as the bp.conf VERBOSE entry (Global logging level). The BPDBM_VERBOSE entry overrides the bp.conf VERBOSE entry (Global 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 minimizing the rate of growth of the bpdbm debug file:


39

VERBOSE = 5 BPDBM_VERBOSE = -1

For more information about the bpdbm debug log, see the NetBackup Troubleshooting Guide for UNIX and Windows.

BPRD_VERBOSEUsed for debugging purposes, the BPRD_VERBOSE option controls the amount of information NetBackup includes in its bprd debug logs. Use this option by adding it to the /usr/openv/netbackup/bp.conf file on a UNIX master server. Or, set the BPRD logging level property in the Logging host properties. For more information, see Chapter 7 of the NetBackup Administrators Guide, Volume I. Default: The same value as the bp.conf VERBOSE entry (Global logging level). The BPRD_VERBOSE entry overrides the bp.conf VERBOSE entry (Global 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 Troubleshooting Guide for UNIX and Windows.

BPTM_VERBOSEUsed for debugging purposes, the BPTM_VERBOSE option controls the amount of information NetBackup includes in its bptm debug logs.


Use this option by adding it to the /usr/openv/netbackup/bp.conf file on a UNIX master server. Or, set the BPTM logging level property in the Logging host properties. For more information, see Chapter 7 of the NetBackup Administrators Guide, Volume I. Default: The same value as the bp.conf VERBOSE entry (Global logging level). The BPTM_VERBOSE entry overrides the bp.conf VERBOSE entry (Global 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 Troubleshooting Guide for UNIX and Windows.

BPEND_TIMEOUTNote: 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 to complete. Default: Timeout is 300 seconds. Use this option by adding it to the /usr/openv/netbackup/bp.conf file on a UNIX master server. Or, set the Backup end notify timeout property in the Timeouts host properties. For more information, see Chapter 7 of the NetBackup Administrators Guide, Volume I.


41

BPSTART_TIMEOUT

Note: If you change this option, verify that the CLIENT_READ_TIMEOUT option is also set to the same or higher value. Specifies the number of seconds to wait for the bpstart_notify script on a client to complete. 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 Backup start notify timeout property in the Timeouts host properties. For more information, see Chapter 7 of the NetBackup Administrators Guide, Volume I.

CHECK_RESTORE_CLIENTThe 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_TIMEOUTThe 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_WINDOWThe CLIENT_PORT_WINDOW entry specifies the range of nonreserved ports on this computer that are used for connecting to NetBackup on other computers. This setting applies when it connects to a client configured to accept nonreserved ports. For information on client configuration, see ALLOW_NON_RESERVED_PORTS on page 33. Use this option by adding it to the /usr/openv/netbackup/bp.conf file on NetBackup servers or clients. The following example permits ports from 4800 through 5000:


CLIENT_PORT_WINDOW = 4800 5000 If you specify 0 for the first number (default), the operating system determines the nonreserved port to use. Refer to NBJAVA_CLIENT_PORT_WINDOW on page 664 in the Administrators Guide, Volume I for connections from the NetBackup-Java console.

CLIENT_READ_TIMEOUTNote: 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. The CLIENT_READ_TIMEOUT entry specifies the number of seconds to use for the client-read timeout. Use this option by adding it to the /usr/openv/netbackup/bp.conf file on a UNIX master server. Or, set the Client read timeout property in the Timeouts host properties. For more information, see Chapter 7 of the NetBackup Administrators Guide, Volume I. You can also add CLIENT_READ_TIMEOUT on database agents (such as NetBackup for Oracle). CLIENT_READ_TIMEOUT on a database agent is a special case because these types of clients can initially require more time to get ready than other clients. Database backup utilities frequently start several backup jobs at the same time, which slows the CPU. The sequence on a database agent is as follows:

NetBackup on the database agent reads the clients CLIENT_READ_TIMEOUT to find the value to use initially. If the option is not set, the standard default of five minutes is used. When the database agent API receives the servers value, it uses it as the CLIENT_READ_TIMEOUT.

Default: CLIENT_READ_TIMEOUT is not specified on either a server or a database agent and the timeout is 300 seconds. Note: We suggest that you set CLIENT_READ_TIMEOUT on the database agent to a value greater than 5 minutes. A setting of 15 minutes has been found to be adequate for many installations.


43

CLIENT_RESERVED_PORT_WINDOWThe CLIENT_RESERVED_PORT_WINDOW entry specifies the range of reserved ports on this computer that are used for connecting to NetBackup on other computers. This setting applies when connecting to a client configured to accept only reserved ports. For information on client configuration, see ALLOW_NON_RESERVED_PORTS on page 33. Use this option by adding it to the /usr/openv/netbackup/bp.conf file on a UNIX master server or client. The following example permits ports from 900 through 1023: CLIENT_RESERVED_PORT_WINDOW = 900 1023 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_OPTIONSThe 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 daemons port number, by using vnetd only, or by using the daemons 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. For more information, see Chapter 7 of the NetBackup Administrators Guide, Volume I. To use this entry, add it to /usr/openv/netbackup/bp.conf on NetBackup servers in the following format: 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.


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 Administrators 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 daemons 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


45

bpcd connections to server perch must use a reserved port number and vnetd. Connections to bpdbm, vmd, bprd, and robotic daemons on server perch must use the daemons port number. 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 daemons port number. Refer to NBJAVA_CONNECT_OPTION on page 665 in the Administrators Guide, Volume I for connections from the NetBackup-Java Console.

DEFAULT_CONNECT_OPTIONSThe DEFAULT_CONNECT_OPTIONS entry specifies the default values for the CONNECT_OPTIONS configuration entry. If a host name is not specified in any CONNECT_OPTIONS entry, the value from the DEFAULT_CONNECT_OPTIONS entry is used. 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. For more information, see Chapter 7 of the NetBackup Administrators Guide, Volume I. To use this entry, add it to /usr/openv/netbackup/bp.conf on NetBackup servers in the following format: DEFAULT_CONNECT_OPTIONS

6.5 admin guide 2 (unix)

Documents