bsla

Displays information about service class configuration for service-level agreement (SLA) scheduling

Synopsis

bsla [service_class_name]
bsla [-h | -V]

Description

bsla displays the properties of service classes configured in lsb.serviceclasses and dynamic information about the state of each configured service class.

If a default system service class is configured with ENABLE_DEFAULT_EGO_SLA in lsb.params but no other service classes are explicitly configured in lsb.serviceclasses, bsla only displays information for the default SLA.

Options

service_class_name

The name of a service class configured in lsb.serviceclasses.

-h

Prints command usage to stderr and exits.

-V

Prints LSF release version to stderr and exits.

Time-based SLA service class output

Time-based SLAs include those with throughput, velocity, or dealine goals. A list of service classes is displayed with the following fields:

SERVICE CLASS NAME

The name of the service class, followed by its description, if any.

PRIORITY

The service class priority. A higher value indicates a higher priority, relative to other service classes. Similar to queue priority, service classes access the cluster resources in priority order.

USER GROUP

User names or user groups who can submit jobs to the service class.

GOAL

The type of service class goal and its configured value:

  • THROUGHPUT

  • VELOCITY

  • DEADLINE

ACTIVE WINDOW

The configured time window when the service class goal is active. If a throughput or velocity goal has no time window configured, ACTIVE WINDOW is Always Open.

STATUS

Current status of the service class goal:

  • Active:On time — the goal is active and meeting its target.

  • Active:Delayed — the goal is active but is missing its target.

  • Inactive — the goal is not active; its time window is closed. Jobs are scheduled as if no service class is defined. LSF does not enforce any service-level goal for an inactive SLA.

THROUGHPUT

For throughput goals, the configured job throughput (finished jobs per hour) for the service class.

SLA THROUGHPUT

The current throughput for the SLA finished jobs per clean period.

ESTIMATED FINISH TIME

For goals with a time window, estimated finish time of the SLA. If the service class status is on time, the finish time is before the configured deadline. If the service class status is delayed, the service class is missing its goal and bsla shows a finish time later than the deadline.

OPTIMUM NUMBER OF RUNNING JOBS

For goals with a time window, the optimum number of jobs that should be running in the service class for the SLA to meet its goal.

NJOBS

The current number of jobs in the specified service class. A parallel job is counted as 1 job, regardless of the number of job slots it uses.

PEND

The number of pending jobs in the specified service class.

RUN

The number of running jobs in the specified service class.

SSUSP

The number of system-suspended jobs in the service class.

USUSP

The number of user-suspended jobs in the specified service class.

FINISH

The number of jobs in the specified service class in EXITED or DONE state.

Resource-based SLA service class output

Resource-based SLAs are those with guarantee goals. A list of service classes is displayed with the following fields:

SERVICE CLASS NAME

The name of the service class, followed by its description, if any.

GOAL

The type of service class goal and its configured value:

  • GUARANTEE

AUTO_ATTACH

Automatic attachment configuration (Y or N).

ACCESS_CONTROL

Configured access restrictions for the guarantee SLA, if any.

POOL NAME

Name of the guaranteed resource pool.

TYPE

Guaranteed resource type.

GUAR CONFIG

Number of resources in the pool guaranteed to the SLA.

GUAR USED

Number of resources within the guarantee in use by the SLA. Resource use includes both running and suspended jobs.

TOTAL USED

Number of resources in the pool currently in use by the SLA. This may exceed the number of guaranteed resources for the SLA if other guarantee SLAs using the same resource pool are not running at capacity. Resource use includes both running and suspended jobs.

EGO-enabled SLA service class output

In addition to the general output, EGO-enabled SLA service classes display the following fields:

CONSUMER

The name of the EGO consumer from which hosts are allocated to the SLA.

EGO_RES_REQ

The EGO resource requirement defined in the SLA.

MAX_HOST_IDLE_TIME

How long the SLA holds its idle hosts before LSF releases them to EGO.

NUM_RECALLED_HOSTS

The number of hosts allocated to the SLA that EGO has reclaimed.

RECALLED_HOSTS_TIMEOUT

The amount of time EGO gives to LSF to clean up its workload before EGO reclaims the host.

Examples

The following time-based service class named Duncan is configured in lsb.serviceclasses:
Begin ServiceClass
NAME = Duncan
CONSUMER = Duncan
PRIORITY = 23
USER_GROUP = user1 user2
GOALS = [VELOCITY 8 timeWindow (9:00-17:30)] \ 
[DEADLINE timeWindow (17:30-9:00)] 
DESCRIPTION = Daytime/Nighttime SLA
End ServiceClass
bsla shows the following properties and current status:
bsla Duncan 
SERVICE CLASS NAME:  Duncan
 -- Daytime/Nighttime SLA
PRIORITY:  23
CONSUMER: Duncan
EGO_RES_REQ: any host
MAX_HOST_IDLE_TIME: 120
USER_GROUP:  user1 user2
 
GOAL:  VELOCITY 8
ACTIVE WINDOW: (9:00-17:30) 
STATUS:  Active:On time
SLA THROUGHPUT:  0.00 JOBS/CLEAN_PERIOD
GOAL:  DEADLINE 
ACTIVE WINDOW: (17:30-9:00) 
STATUS:  Inactive
SLA THROUGHPUT:  0.00 JOBS/CLEAN_PERIOD
 
 NJOBS   PEND    RUN     SSUSP   USUSP   FINISH
      0      0       0        0       0       0

The following resource pools named linuxPool and solarisPool are configured in lsb.resources:

Begin GuaranteedResourcePool
NAME =linuxPool
TYPE = hosts
HOSTS = linuxHG
DISTRIBUTION = [[sla1,10%] [sla2,25%]
DESCRIPTION = A linux resource pool used by sla1, and sla2.
End GuaranteedResourcePool
 
Begin GuaranteedResourcePool
NAME =solarisPool
TYPE = hosts
HOSTS = solarisHG
DISTRIBUTION = [[sla1,20%] [sla2,30%] [sla3,25%]]
DESCRIPTION = A solaris resource pool used by sla1, sla2, and sla3.
End GuaranteedResourcePool

bsla shows the following for sla1:

> bsla sla1
SERVICE CLASS NAME:  sla1
AUTO ATTACH: N
 
GOAL:  GUARANTEE 
 
                    GUAR    GUAR    TOTAL
POOL NAME    TYPE   CONFIG  USED    USED
linuxPool    hosts  10      0       0
solarisPool  hosts  20      0       0

See also

bresources(1), bhist(1), bjobs(1), bkill(1), bmod(1), bsub(1), lsb.acct(5), lsb.serviceclasses(5) lsb.resources(5)