Configure all LSF License Scheduler distribution policies in the lsf.licensescheduler file.
Configure a separate Feature section for each license feature. For each license feature, specify the service domain and the distribution policy. Distribution is indicated by specifying the license project name and share assignment.
To see the distribution policies configured by the License Scheduler administrator, run blinfo with no options.
When you configure the ownership and sharing of the licenses for a feature in lsf.licensescheduler, specify the following for each project:
In lsf.licensescheduler, configure the feature with two license projects.
In the following example, each project is entitled to 50% of the total number of license tokens.
Initially, one project may be using most of the tokens. Later the other project may require tokens. As tokens become available, License Scheduler distributes them according to the ratio of the shares.
In lsf.licensescheduler, configure the feature with two license projects.
Lp1 is guaranteed 5 tokens and can preempt them from Lp2 if necessary. As tokens become available, License Scheduler distributes them according to their shares (3:1).
In lsf.licensescheduler, configure the feature with two license projects.
Do this by adding a non-shared distribution parameter to the Feature section.
Begin Feature
NAME=AppZ
DISTRIBUTION=LanServer1(Lp1 3/5 Lp2 1)
NON_SHARED_DISTRIBUTION=LanServer1(Lp1 2)
End Feature
Lp1 can receive five tokens on demand.
As tokens become available, License Scheduler distributes them by their shares. For example, if the total number of licenses is 60, and Lp1 is guaranteed five owned licenses (three shared and preemptable, two not shared), it is entitled to another 40 licenses according to its share (3:1).
Use blinfo -a to display NON_SHARED_DISTRIBUTION information:
You can optionally configure default projects for a feature.
Default includes all projects that have not been defined in the PROJECTS section of lsf.licensescheduler. Jobs that belong to projects that are defined in lsf.licensescheduler do not get a share of the tokens when the project is not explicitly defined in the distribution.
Use blinfo to display license usage information about jobs that you submit without specifying a project. They can be viewed under the default project.
For example, you configure your Feature section as follows:
If you submit a job that requires a license for AppZ without specifying a project, your job will pend, even if projects Lp1 and Lp2 are not using or waiting for licenses.
If you submit a job that requires a license for AppZ without specifying a project, your job runs if there are free licenses, which are distributed according to the shares specified in the policy. In this example, jobs that do not specify a project receive a quarter of the license tokens.
If you submit a job that requires a license for AppZ without specifying a project, your job runs if there are free licenses. The only advantage of using this configuration is the ability to view usage information.
In lsf.licensescheduler, you can configure a feature so that its license is preemptable when reserved or already in use by other projects. Do this by adding PREEMPT_RESERVE=Y to the Feature section.
If no licenses are available and project Lp1 is using fewer than 5 licenses, project Lp1 preempts a reserved license from project Lp2 and checks out the license from the license server.
With License Scheduler, licenses are reserved before it is actually necessary to check them out from the license server.
When you submit a job that requires a license feature at the conclusion of its run, it could take a long time before the license actually is checked out by the application requiring it. While the job runs, the license is reserved even though it is not in use. The job has reserved this license.
At the same time, you may want to submit a shorter job that requires the same license. You can preempt the reserved license if all of the following criteria are true:
Normally, license token names should be the same as the FLEXnet feature names, as they represent the same license. However, LSF does not support names that start with a number, or names containing a dash or hyphen character (-), which may be used in the FLEXnet feature name.
For these feature names, you must set both NAME and FLEX_NAME in the Features section of lsf.licensescheduler. FLEX_NAME is the actual FLEXnet feature name, and NAME is an arbitrary license token name you choose.