Using the nbrbutil utility to configure the NetBackup Resource Broker on UNIX/Linux

Article:HOWTO42484  |  Created: 2011-02-28  |  Updated: 2011-03-10  |  Article URL http://www.symantec.com/docs/HOWTO42484
Article Type
How To


Environment

Subject


Using the nbrbutil utility to configure the NetBackup Resource Broker on UNIX/Linux

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 UNIX:

    /usr/openv/netbackup/bin/admincmd/nbrbutil

  • On Windows:

    Install_path\VERITAS\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 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.

-disablePerfMon

Disables performance monitoring.

-enablePerfMon

Enables performance monitoring.

-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 are allocated by the MDS with 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 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 (for example, a tape span request, or a request for a synthetic or a duplication job), nbrb immediately interrupts the evaluation cycle. nbrb releases and unloads drives, if required before the evaluation cycle begins again.

If the RB_BREAK_EVAL_ON_DEMAND parameter is set to true (default), interruptions of high priority jobs are not allowed and the evaluation cycle continues.

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 on UNIX/Linux.

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

For additional information about the nbrbutil utility, see the Commands Reference Guide.


Legacy ID



nbrbutil_changesettings_v46435089


Article URL http://www.symantec.com/docs/HOWTO42484


Terms of use for this information are found in Legal Notices