Configure LSF License Scheduler

LSF License Scheduler automatically distributes unused licenses to the projects that need them. Your configured distribution policies take effect when the system is fully loaded and there is competition for resources. You can update the license distribution policies and change the share allocations at any time. You can also update the configuration to add new licenses or new projects.

Configuration files

The LSF License Scheduler configuration files are located in $LSF_ENVDIR.

Tip:

See the Platform LSF Reference for details about the LSF License Scheduler configuration parameters.

lsf.licensescheduler

The lsf.licensescheduler file contains the LSF License Scheduler configuration information, including the license distribution policies, which describe how many license features are controlled by LSF and how the licenses are to be shared or owned in the event of competition among projects.

The following sections are required:

  • Parameters — License Scheduler configuration parameters

  • Projects — lists the License Scheduler projects

  • Clusters — lists the clusters that can use License Scheduler

  • ServiceDomain — defines License Scheduler service domains as groups of physical license server hosts that serve a specific network

  • Feature — defines license distribution policies for application license features

The ProjectGroup section is optional — defines hierarchical relationships among projects.

Use a line continuation character “\” to continue a line

lsf.conf

Parameters in lsf.conf that start with LSF_LIC_SCHED are relevant to both LSF and License Scheduler:

  • LSF_LIC_SCHED_HOSTS — LIM starts the License Scheduler daemon (bld) on candidate License Scheduler hosts.

CAUTION:

You cannot use LSF_LIC_SCHED_HOSTS if your cluster was installed with UNIFORM_DIRECTORY_PATH or UNIFORM_DIRECTORY_PATH_EGO. Do not set UNIFORM_DIRECTORY_PATH or UNIFORM_DIRECTORY_PATH_EGO for new or upgrade installations. They are for backwards compatibility only.

  • LSF_LIC_SCHED_PREEMPT_REQUEUE — requeues a job whose license is preempted by License Scheduler. The job will be killed and requeued instead of suspended.

  • LSF_LIC_SCHED_PREEMPT_SLOT_RELEASE — releases the slot of a job that is suspended when the its license is preempted by License Scheduler.

  • LSF_LIC_SCHED_PREEMPT_STOP — uses job controls to stop a job that is preempted. When this parameter is set, a UNIX SIGSTOP signal is sent to suspend a job instead of a UNIX SIGTSTP.

  • LSF_LIC_SCHED_STRICT_PROJECT_NAME—enforces strict checking of the License Scheduler project name upon job submission. If the project named is misspelled (case sensitivity applies), the job is rejected.

License Scheduler uses the following LSF parameters:

  • LSB_SHAREDIR — directory where the job history and accounting logs are kept for each cluster

  • LSF_LICENSE_FILE — one or more demo or FLEXnet-based permanent license files used by LSF

  • LSF_LICENSE_ACCT_PATH — location for the license accounting files, including the license accounting files for LSF Family products

  • LSF_LOG_MASK — logging level of error messages for LSF daemons

  • LSF_LOGDIR — LSF system log file directory

When you change your configuration

After making any change to lsf.licensescheduler:

  1. Use bld -C to test for configuration errors.

  2. Run bladmin reconfig all to reconfigure LSF License Scheduler and make the changes take effect.

After making any change to lsf.conf or other LSF configuration files:

  1. Use bld -C to test for configuration errors.

  2. Run bladmin reconfig all to reconfigure LSF License Scheduler and make the changes take effect.

  3. Run badmin mbdrestart to restart mbatchd.

Note:

When LSF is reconfigured (badmin reconfig) bld a restarts. (Platform LSF Version 7 Update 5 onwards.)