Veritas NetBackup™ Administrator's Guide, Volume I
- Section I. About NetBackup
- Section II. Configuring hosts
- Configuring Host Properties
- About the NetBackup Host Properties
- Access Control properties
- Bandwidth properties
- Busy File Settings properties
- Client Attributes properties
- Client Settings properties for UNIX clients
- Client Settings properties for Windows clients
- Data Classification properties
- Default Job Priorities properties
- Encryption properties
- Exchange properties
- Exclude Lists properties
- Fibre Transport properties
- Firewall properties
- General Server properties
- Global Attributes properties
- Logging properties
- Login Banner Configuration properties
- Media properties
- Network Settings properties
- Port Ranges properties
- Preferred Network properties
- Resilient Network properties
- Restore Failover properties
- Retention Periods properties
- Scalable Storage properties
- Servers properties
- SharePoint properties
- SLP Parameters properties
- Throttle Bandwidth properties
- Universal Settings properties
- User Account Settings properties
- Configuration options for NetBackup servers
- ECA_CERT_PATH for NetBackup servers and clients
- PREFERRED_NETWORK option for NetBackup servers
- THROTTLE_BANDWIDTH option for NetBackup servers
- Configuration options for NetBackup clients
- IGNORE_XATTR option for NetBackup clients
- VXSS_NETWORK option for NetBackup clients
- Configuring server groups
- Enabling support for NAT clients and NAT servers in NetBackup
- Configuring host credentials
- Managing media servers
- Configuring Host Properties
- Section III. Configuring storage
- Configuring disk storage
- Configuring robots and tape drives
- About configuring robots and tape drives in NetBackup
- Adding a robot to NetBackup manually
- Managing robots
- Adding a tape drive to NetBackup manually
- Adding a tape drive path
- Correlating tape drives and device files on UNIX hosts
- Managing tape drives
- Performing device diagnostics
- Configuring tape media
- About NetBackup volume pools
- About WORM media
- About adding volumes
- Configuring media settings
- Media settings options
- Media type (new media setting)
- Media settings options
- About barcodes
- Configuring barcode rules
- Configuring media ID generation rules
- Adding volumes by using the Actions menu
- Configuring media type mappings
- Managing volumes
- About exchanging a volume
- About frozen media
- About injecting and ejecting volumes
- About rescanning and updating barcodes
- About labeling NetBackup volumes
- About moving volumes
- About recycling a volume
- Managing volume pools
- Managing volume groups
- Inventorying robots
- About showing a robot's contents
- About updating the NetBackup volume configuration
- About the vmphyinv physical inventory utility
- Configuring storage units
- About the Storage utility
- Creating a storage unit
- About storage unit settings
- Absolute pathname to directory or absolute pathname to volume setting for storage units
- Maximum concurrent jobs storage unit setting
- Staging backups
- Creating a basic disk staging storage unit
- Configuring storage unit groups
- Section IV. Configuring storage lifecycle policies (SLPs)
- Configuring storage lifecycle policies
- Storage operations
- Index From Snapshot operation in an SLP
- Snapshot operation in an SLP
- Retention types for SLP operations
- Capacity managed retention type for SLP operations
- Storage lifecycle policy options
- Using a storage lifecycle policy to create multiple copies
- Storage lifecycle policy versions
- Section V. Configuring backups
- Creating backup policies
- Planning for policies
- Policy Attributes tab
- Policy storage (policy attribute)
- Policy volume pool (policy attribute)
- Take checkpoints every __ minutes (policy attribute)
- Backup Network Drives (policy attribute)
- Cross mount points (policy attribute)
- Encryption (policy attribute)
- Collect true image restore information (policy attribute) with and without move detection
- Use Accelerator (policy attribute)
- Enable optimized backup of Windows deduplicated volumes
- Use Replication Director (policy attributes)
- Schedule Attributes tab
- Type of backup (schedule attribute)
- Frequency (schedule attribute)
- Multiple copies (schedule attribute)
- Retention (schedule attribute)
- Media multiplexing (schedule attribute)
- Start Window tab
- Include Dates tab
- How open schedules affect calendar-based and frequency-based schedules
- About the Clients tab
- Backup Selections tab
- Adding backup selections to a policy
- Verifying the Backup Selections list
- Pathname rules for UNIX client backups
- About the directives on the Backup Selections list
- ALL_LOCAL_DRIVES directive
- Files that are excluded from backups by default
- Disaster Recovery tab
- Active Directory granular backups and recovery
- Synthetic backups
- Using the multiple copy synthetic backups method
- Protecting the NetBackup catalog
- Parts of the NetBackup catalog
- Protecting the NetBackup catalog
- Archiving the catalog and restoring from the catalog archive
- Estimating catalog space requirements
- About the NetBackup relational database
- About the NetBackup relational database (NBDB) installation
- Using the NetBackup Database Administration utility on Windows
- Using the NetBackup Database Administration utility on UNIX
- Post-installation tasks
- About backup and recovery procedures
- Managing backup images
- Configuring immutability and indelibility of data in NetBackup
- Creating backup policies
- Section VI. Deployment Management
- Deployment Management
- Adding or changing schedules in a deployment policy
- Deployment Management
- Section VII. Configuring replication
- About NetBackup replication
- About NetBackup Auto Image Replication
- Viewing the replication topology for Auto Image Replication
- About the storage lifecycle policies required for Auto Image Replication
- Removing or replacing replication relationships in an Auto Image Replication configuration
- About NetBackup replication
- Section VIII. Monitoring and reporting
- Monitoring NetBackup activity
- About the Jobs tab
- About the Daemons tab
- About the Processes tab
- About the Drives tab
- About the jobs database
- About pending requests and actions
- Reporting in NetBackup
- Email notifications
- Monitoring NetBackup activity
- Section IX. Administering NetBackup
- Management topics
- Accessing a remote server
- Using the NetBackup Remote Administration Console
- Run-time configuration options for the NetBackup Administration Console
- About improving NetBackup performance
- About adjusting time zones in the NetBackup Administration console
- Alternate server restores
- About performing alternate server restores
- Managing client backups and restores
- About client-redirected restores
- Powering down and rebooting NetBackup servers
- About Granular Recovery Technology
- About configuring Services for Network File System (NFS)
Using the nbrbutil utility to configure the NetBackup Resource Broker
The NetBackup Resource Broker (nbrb) allocates resources and maintains resource requests for jobs in the job queue. Use the nbrbutil utility to configure the Resource Broker.
The nbrbutil utility is located in the following directory:
On Windows: install_path\NetBackup\bin\admincmd\nbrbutil
On UNIX: /usr/openv/netbackup/bin/admincmd/nbrbutil
For a complete description of nbrbutil, see the NetBackup Commands Reference Guide.
Table: nbrbutil options describes the options available to nbrbutil command.
Table: nbrbutil options
Option | Description |
---|---|
-cancel requestID | Cancels the allocation request within the given identifier. |
-changePriority requestID | Changes the request priority. |
-changePriorityClass requestID -priorityClass priorityClass | Changes the request priority class. |
-changeSettings parameterparameter_value | Adds or changes the nbrb configuration settings. Table: nbrbutil -changesettings parameters describes the configuration settings in detail. |
-deleteSetting settingname | Deletes a Resource Broker configuration setting that is identified by settingname. |
-dump | Dumps all Resource Broker allocation and request lists. |
-dumptables [-f filename] | Enables the Resource Broker to log its internal state in the specified file name. |
-help | Lists the help for this command. |
-listActiveDriveJobs [driveName] | Lists all the active jobs for a drive. |
-listActiveJobs | Lists all the active jobs. |
-listActiveMediaJobs mediaId | Lists all the active jobs for a media ID (disk or tape). |
-listActivePoolJobs poolName | Lists all the active jobs for a volume pool. |
-listActiveStuJobs stuName|stugroup | Lists all the active jobs for a storage unit or a storage unit group. |
-listOrphanedDrives | Lists the drives that are reserved in EMM but have no corresponding allocation in the Resource Broker. |
-listOrphanedMedia | Lists the media that is reserved in EMM but has no corresponding allocation in the Resource Broker. |
-listOrphanedPipes | Lists the orphaned Fibre Transport pipes. |
-listOrphanedStus | Lists the storage units that are reserved in EMM but have no corresponding allocation in the Resource Broker. |
-listSettings | Lists the configuration settings of the Resource Broker. |
-priority priority | Changes the request priority. |
-release allocationID | Release the allocation with the given identifier. |
-releaseAllocHolds | Releases the allocation holds caused by allocation errors for drives and media. |
-releaseDrive drivename | Releases all allocations for the named drive. |
-releaseMDS mdsAlocationKey | Releases the EMM and the MDS allocations that MDS allocates by the specified identifier. |
-releaseMedia mediaid | Releases all allocations for the specified volume. |
-releaseOrphanedDrive drivekey | Releases the drives that are reserved in EMM but have no corresponding allocation in the Resource Broker. |
-releaseOrphanedMedia mediakey | Releases the media that are reserved in EMM but have no corresponding allocation in the Resource Broker. |
-releaseOrphanedPipes | Releases the orphaned Fibre Transport pipes. |
-releaseOrphanedStu stuName | Releases the storage units that are reserved in EMM but have no corresponding allocation in the Resource Broker. |
-reportInconsistentAllocations | Reports inconsistent the allocations between the Resource Broker and MDS. |
-resetAll | Resets all Resource Broker allocations, requests, and persisted states. |
-resetMediaServer mediaserver | Resets all Resource Broker EMM and MDS allocations that are related toltid on the media server. |
-resume | Resumes the Resource Broker processing. |
-setDriveGroupUnjoinable | Disables the future job from joining the group for this drive. |
-setMediaGroupUnjoinable | Disables the future job from joining the group for this media. |
-suspend | Suspends the Resource Broker processing. |
-syncAllocations | Syncs up any allocation difference between the Resource Broker and MDS. |
Table: nbrbutil -changesettings parameters lists the parameters for the nbrbutil -changesettings option, and describes the use of each.
Use the nbrbutil command with the -changesettings option to add or change Resource Broker configuration settings.
Table: nbrbutil -changesettings parameters
Parameter | Description |
---|---|
RB_DO_INTERMITTENT_UNLOADS | When the RB_DO_INTERMITTENT_UNLOADS parameter is set to true (default), nbrb initiates unloads of the drives that have exceeded the media unload delay. Drives become available more quickly to jobs that require different media servers or different media than the job that last used the drive. However, the loaded media or drive pair may not be available for jobs with less priority in the prioritized evaluation queue that can use the drive or media without unload. RB_DO_INTERMITTENT_UNLOADS=true |
RB_ENABLE_OPTIMIZATION | When the RB_ENABLE_OPTIMIZATION parameter is set to true (default), this entry instructs nbrb to cache states of resource requests. RB_ENABLE_OPTIMIZATION=true |
RB_RESPECT_REQUEST_PRIORITY | When the RB_RESPECT_REQUEST_PRIORITY parameter is set to false (default), nbrb continues to evaluate jobs in the prioritized job queue. As a result, a job is likely to reuse a drive more quickly after the drive has been released. However, some lower priority jobs may receive drives before higher priority jobs do. When the RB_RESPECT_REQUEST_PRIORITY parameter is set to true, nbrb restarts its evaluation queue at the top of the prioritized job queue after resources have been released. RB_RESPECT_REQUEST_PRIORITY=false |
RB_BREAK_EVAL_ON_DEMAND | When a high priority request appears (a tape span request, a subsequent request for a synthetic or a duplication job, or a read request for an optimized duplication), nbrb immediately interrupts the evaluation cycle. nbrb releases and unloads drives, if required, before a new evaluation cycle is started. If the RB_BREAK_EVAL_ON_DEMAND parameter is set to true (default), the evaluation cycle can be interrupted by high priority requests. RB_BREAK_EVAL_ON_DEMAND=true |
RB_MAX_HIGH_PRIORITY_QUEUE_SIZE | Spanning requests and additional resources for an active duplication job are put in a special queue for priority processing. The RB_MAX_HIGH_PRIORITY_QUEUE_SIZE parameter sets the maximum number of requests that NetBackup allows in that queue. (Default: 100 requests.) RB_MAX_HIGH_PRIORITY_QUEUE_SIZE=100 |
RB_RELEASE_PERIOD | The RB_RELEASE_PERIOD parameter indicates the interval that NetBackup waits before it releases a resource. (Default: 180 seconds.) RB_RELEASE_PERIOD=180 |
RB_CLEANUP_OBSOLETE_DBINFO | The RB_CLEANUP_OBSOLETE_DBINFO parameter indicates the number of seconds that can elapse between the cleanup of obsolete information in the nbrb database. (Default: 60 seconds.) RB_CLEANUP_OBSOLETE_DBINFO=60 |
RB_MPX_GROUP_UNLOAD_DELAY | The RB_MPX_GROUP_UNLOAD_DELAY parameter indicates the number of seconds that nbrb waits for a new job to appear before a tape is unloaded. (Default: 10 seconds.) RB_MPX_GROUP_UNLOAD_DELAY=10 This setting can help avoid unnecessary reloading of tapes and applies to all backup jobs. During user backups, nbrb uses the maximum value of RB_MPX_GROUP_UNLOAD_DELAY and the Media unmount delay host property setting when nbrb unmounts the tape. During restores, Media unmount delay is used, not RB_MPX_GROUP_UNLOAD_DELAY. See Timeouts properties. |
RB_RETRY_DELAY_AFTER_EMM_ERR | The RB_RETRY_DELAY_AFTER_EMM_ERR parameter indicates how long NetBackup waits after an EMM error before it tries again. The error must be one where a retry is possible. For example, if a media server is down. (Default: 60 seconds.) RB_RETRY_DELAY_AFTER_EMM_ERR=60 |
RB_REEVAL_PENDING | The RB_REEVAL_PENDING parameter indicates the number of seconds that can elapse between evaluations of the pending request queue. For example, a pending request queue can include, jobs awaiting resources. (Default: 60 seconds.) RB_REEVAL_PENDING=60 |
RB_REEVAL_PERIOD | The RB_REEVAL_PERIOD parameter indicates the time between evaluations if an outstanding request is not satisfied, and if no other requests or resources have been released. (Default: Five minutes must pass before the initial request is reevaluated.) RB_REEVAL_PERIOD=300 |