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 mount timeout host property setting when nbrb unmounts the tape. During restores, Media mount timeout 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 |