Cluster mode distributes licenses across LSF clusters. To guarantee license resources to projects within a cluster and allow loaning of license resources when not in use, use LSF guarantee-type SLAs. Guarantees and loans in cluster mode are similar to non-shared licenses and ownership in project mode.
A guarantee provides jobs belonging to set consumers with specific resources (such as hosts). Jobs run using guaranteed resources when possible. Once the guaranteed resources are used, jobs run outside the guarantee following whatever other scheduling features are configured. Guarantees are configured within a guaranteed resource pool.
Guarantee SLAs are configured in Platform LSF. For more information see Administering Platform LSF and Platform LSF Configuration Reference.
Service classes allow access to guaranteed resources. Configure a service class for each license project in the cluster.
You can configure as many service class sections as you need.
When the optional parameter AUTO_ATTACH is set, jobs are automatically attached to the service class.
When automatic attachment is not set, jobs can be submitted to the service class using bsub -sla serviceclass_name.
If a job can access more than one SLA with automatic attachment set, it is attached to the first valid SLA in the order of the configuration file.
Begin ServiceClassNAME = sla1GOALS = [GUARANTEE]ACCESS_CONTROL=LIC_PROJECTS[ proj1 ]AUTO_ATTACH=YDESCRIPTION = A guarantee SLA with access restricted to the license project proj1. Jobs submitted to proj1 are attached to the SLA automatically and run on guaranteed resources if possible.End ServiceClass
Guaranteed resource pools provide a minimum resource guarantee to consumers, and can optionally loan out guaranteed resources not in use.
Guaranteed resource pools are defined in lsb.resources and used by consumers defined within ServiceClass sections in lsb.serviceclasses.
You can configure as many resource pools as you need. One resource pool can be used by several SLAs, and one SLA can access multiple resource pools.
Loans from unused guarantees are recommended when using cluster mode. When loans are disabled, use a static license distribution policy.
When configured, unused license resources are loaned out based on the loan policy. The loan policy allows specific queues to access unused resources from guaranteed resource pools.
DURATION allows you to set a maximum job runtime limit (or estimated runtime, whichever is shorter) for jobs to borrow resources. Omit DURATION completely to allow jobs with any runtime to borrow from the gurantee.
For example, to allow loans to jobs from any queue with a runtime of 10 minutes or less:
Loans can be restricted so that jobs have access to the loaned resources only when consumers with unused guaranteed resources do not have pending loads.
Restricting loans is useful when running jobs that require several licenses. With restricted loans enabled, loaning out single licenses will not delay jobs waiting for license resources to accumulate.