bresources

Displays information about resource reservation, resource limits, and guaranteed resource pool configuration.

Synopsis

bresources -s [resource_name ...]
bresources -g [-l [-m]] [resource_pool ...]
bresources [-h | -V]

Description

By default, bresources displays all resource limit configurations in lsb.resources. This is the same as blimits -c.

Options

-s

Displays per-resource reservation configurations from the ReservationUsage section of lsb.resources.

resource_name ...

Used with -s, displays reservation configurations about the specified resource.

-g

Displays guaranteed resource pool configurations from the GuaranteedResourcePool section of lsb.resources. The following information about each guaranteed resource pool is displayed: name, type, status, available resources, unused resources, total configured resource guarantees, and number of guaranteed resources currently unused.

-l

With -g, displays guaranteed resource pool configuration from the GuaranteedResourcePool section of lsb.resources in a long multiline format. The -l options displays the following additional information: description, distribution of guarantees among SLAs, special policies, configured hosts list, static resource requirement select string, and for each guarantee made from the resource pool the name, resources guaranteed, and resources currently in use.

-m

With -g and -l, displays the names of all hosts included in each guaranteed resource pool configuration from the GuaranteedResourcePool section of lsb.resources.

resource_pool ...

Only displays information about the specified resource pool.

-h

Prints command usage to stderr and exits.

-V

Prints LSF release version to stderr and exits.

Guaranteed resource pool output (-g)

POOL_NAME

Configured name of the guaranteed resource pool.

TYPE

Configured type of guaranteed resource pool.

STATUS

Whether the guarantee is being met. Possible values are:

  • ok

  • unknown

  • overcommitted: More resources guaranteed than in pool.

  • close_loans: Loaning suspended due to pending demand.

    This state only occurs when CLOSE_ON_DEMAND is set in LOAN_POLICIES, and at least one job is pending for an SLA that is not using all of its configured guarantee.

TOTAL

Number of resources included in the guaranteed resource pool.

FREE

Number of unused resources within the guaranteed resource pool.

GUAR CONFIG

Configured number of guaranteed resources.

GUAR USED

Number of guaranteed resources in use. Resource use includes both running and suspended jobs.

Long output (-gl)

In addition to the fields included in the guaranteed resource pool output (option -g), the long output includes the following fields.

GUARANTEED RESOURCE POOL

Name and description of guaranteed resource pool.

DISTRIBUTION

Configured distribution of guarantees among SLAs.

LOAN_POLICIES

Configured policies.

HOSTS

Configured hosts list.

CONSUMERS

Name of each SLA guarantee made from the guaranteed resource pool.

GUAR CONFIG

Number of resources in the pool guaranteed to the SLA.

GUAR USED

Number of resources currently in use by the SLA to meet the guarantee. Once the guarantee is met, additional jobs from the SLA running in the resource pool do not count towards the guarantee, and are not included. Resource use includes both running and suspended jobs.

TOTAL USED

Total number of resources used by the SLA. Resource use includes both running and suspended jobs.

Long output with hosts (-glm)

In addition to fields included in the long output (option -gl), hosts currently in the resource pool are listed. This includes configured hosts in the states ok, closed_Busy, closed_Excl, closed_cu_Excl, and closed_Full.

Examples

bresources -s
Begin ReservationUsage
RESOURCE            METHOD    RESERVE
license1            PER_HOST     Y
license2            PER_SLOT     Y
license3            PER_JOB      N
license5            PER_HOST     Y
license6            PER_JOB      Y
End ReservationUsage

bresources -s  license1
RESOURCE            METHOD    RESERVE
license1            PER_HOST     Y

bresources -g
                                        GUAR   GUAR
POOL_NAME   TYPE   STATUS    TOTAL FREE CONFIG USED
linuxPool   slots close_loans   8     0    6      2
solarisPool slots ok          8     0    6      2

bresources -g -l
GUARANTEED RESOURCE POOL: Guarantee1
 
TYPE: slots
DISTRIBUTION: [sla1, 50%]
HOSTS: hgA hostB
 
STATUS: ok
 
RESOURCE SUMMARY:
 TOTAL                           3
 FREE                            3
 
  GUARANTEE CONFIGURED            1
  GUARANTEE UNUSED                1
                                         GUAR    GUAR   TOTAL
CONSUMERS                                CONFIG  USED   USED
sla1                                     1       0      0

bresources -g -l -m
GUARANTEED RESOURCE POOL: MyGuarantee
 
TYPE: hosts
DISTRIBUTION: [MySLA, 50%]
LOAN_POLICIES: CLOSE_ON_DEMAND
HOSTS: hostA hostB hostC hostD
 
STATUS: ok
 
RESOURCE SUMMARY:
  TOTAL                           4
  FREE                            4
 
  GUARANTEE CONFIGURED            2
  GUARANTEE UNUSED                2
 
                                         GUAR    GUAR   TOTAL
CONSUMERS                                CONFIG  USED   USED
sla1                                     2       0      0
 
Hosts currently in the resource pool.
 
hostA hostB hostC hostD