blinfo

displays static License Scheduler configuration information

Synopsis

blinfo -Lp | -p | -D | -G | -P
blinfo [-a [-t token_name | "token_name ..."]] [-o alpha | total] [-g "feature_group ..."]
blinfo -A [-t token_name | "token_name ..."] [-o alpha | total ] [-g "feature_group ..."]
blinfo -C [-t token_name | "token_name ..."] [-o alpha | total] [-g "feature_group ..."]
blinfo [-t token_name | "token_name ..."] [-o alpha | total] [-g "feature_group ..."]
blinfo [ -h | -V ]

Description

Displays different license configuration information, depending on the option selected.

By default, displays information about the distribution of licenses managed by License Scheduler.

Options

-A

When LOCAL_TO is configured for a feature in lsf.licensescheduler, shows the feature allocation by cluster locality.

You can optionally provide license token names.

-a

Shows all information, including information about non-shared licenses (NON_SHARED_DISTRIBUTION) and workload distribution (WORKLOAD_DISTRIBUTION).

You can optionally provide license token names.

blinfo -a does not display NON_SHARED information for hierarchical project group scheduling policies. Use blinfo -G to see hierarchical group configuration.

-C

When LOCAL_TO is configured for a feature in lsf.licensescheduler, shows the cluster locality information for the features.

You can optionally provide license token names.

-D

Lists the License Scheduler service domains and the corresponding FlexNet license server hosts.

-G

Lists the hierarchical configuration information.

If PRIORITY is defined in the ProjectGroup Section of lsf.licensescheduler, this option also shows the priorities of each project.

-g feature_group ...

When FEATURE_GROUP is configured for a group of license features in lsf.licensescheduler, shows only information about the features configured in the FEATURE_LIST of specified feature groups. You can specify more than one feature group at one time.

When you specify feature names with -t, features in the feature list defined by -t and feature groups are both displayed.

Feature groups listed with -g but not defined in lsf.licensescheduler are ignored.

-Lp

Lists the active projects managed by License Scheduler.

-Lp only displays projects associated with configured features.

If PRIORITY is defined in the Projects Section of lsf.licensescheduler, this option also lists the priorities of each project.

-o alpha | total

Sorts license feature information alphabetically, or by total licenses.

  • alpha: Features are listed in descending alphabetical order.

  • total: Features are sorted by the descending order of the sum of licenses that are allocated to LSF workload from all the service domains configured to supply licenses to the feature. Licenses borrowed by non-LSF workload are included in this amount.

-P

When LS_FEATURE_PERCENTAGE=Y, lists the license ownership in percentage.

-p

Displays values of lsf.licensescheduler configuration parameters and lsf.conf parameters related to License Scheduler. This is useful for troubleshooting.

-t token_name | "token_name ..."

Only shows information about specified license tokens. Use spaces to separate multiple names, and enclose them in quotation marks.

-h

Prints command usage to stderr and exits.

-V

Prints the License Scheduler release version to stderr and exits.

Default output

Displays the following fields:

FEATURE

The license name. This becomes the license token name.

When LOCAL_TO is configured for a feature in lsf.licensescheduler, blinfo shows the cluster locality information for the license features.

SERVICE_DOMAIN

The name of the service domain that provided the license.

TOTAL

The total number of licenses managed by FlexNet. This number comes from FlexNet.

DISTRIBUTION

The distribution of the licenses among license projects in the format [project_name, percentage[/number_licenses_owned]]. This determines how many licenses a project is entitled to use when there is competition for licenses. The percentage is calculated from the share specified in the configuration file.

Allocation output (-A)

FEATURE

The license name. This becomes the license token name.

When LOCAL_TO is configured for a feature in lsf.licensescheduler, blinfo shows the cluster locality information for the license features.

PROJECT

The License Scheduler project name.

ALLOCATION

The percentage of shares assigned to each cluster for a feature and a project.

All output (-a)

Same as Default Output with NON_SHARED_DISTRIBUTION.

NON-SHARED_DISTRIBUTION

This column is displayed directly under DISTRIBUTION with the -a option. If there are non-shared licenses, then the non-shared license information is output in the following format: [project_name, number_licenses_non_shared]

If there are no non-shared licenses, then the following license information is output - (dash)

Cluster locality output (-C)

NAME

The license feature token name.

When LOCAL_TO is configured for a feature in lsf.licensescheduler, blinfo shows the cluster locality information for the license features.

FLEX_NAME

The actual FlexNet feature name—the name used by FlexNet to identify the type of license. May be different from the License Scheduler token name if a different FLEX_NAME is specified in lsf.licensescheduler.

CLUSTER_NAME

The name of the cluster the feature is assigned to.

FEATURE

The license feature name. This becomes the license token name.

When LOCAL_TO is configured for a feature in lsf.licensescheduler, blinfo shows the cluster locality information for the license features.

SERVICE_DOMAIN

The service domain name.

Service Domain Output (-D)

SERVICE_DOMAIN

The service domain name.

LIC_SERVERS

Names of FlexNet license server hosts that belong the to service domain. Each host name is enclosed in parentheses, as shown:

(port_number@host_name)

Redundant hosts (that share the same FlexNet license file) are grouped together as shown:

(port_number@host_name port_number@host_name port_number@host_name)

Hierarchical Output (-G)

The following fields describe the values of their corresponding configuration fields in the ProjectGroup Section of lsf.licensescheduler.

GROUP

The project names in the hierarchical grouping and its relationships. Each entry specifies the name of the hierarchical group and its members. The entry is enclosed in parentheses as shown:

(group (member ...))

SHARES

The shares assigned to the hierarchical group member projects.

OWNERSHIP

The number of licenses that each project owns.

LIMITS

The maximum number of licenses that the hierarchical group member project can use at any one time.

NON_SHARED

The number of licenses that the hierarchical group member projects use exclusively.

PRIORITY

The priority of the project if it is different from the default behavior. A larger number indicates a higher priority.

DESCRIPTION

The description of the project group.

Project Output (-Lp)

List of active License Scheduler projects.

-Lp only displays projects associated with configured features.

PROJECT

The project name.

PRIORITY

The priority of the project if it is different from the default behavior. A larger number indicates a higher priority.

DESCRIPTION

The description of the project.

Parameters Output (-p)

ADMIN

The License Scheduler administrator. Defined in lsf.licensescheduler.

DISTRIBUTION_POLICY_VIOLATION_ACTION
This parameter includes
  • The interval (a multiple of LM_STAT_INVERVAL periods) at which License Scheduler checks for distribution policy violations, and

  • The directory path and command that License Scheduler runs when reporting a violation

Defined in lsf.licensescheduler.

HOSTS

License Scheduler candidate hosts. Defined in lsf.licensescheduler.

LM_REMOVE_INTERVAL

Minimum time a job must have a license checked out before lmremove can remove the license. Defined in lsf.licensescheduler.

LM_STAT_INTERVAL

Time interval between calls that License Scheduler makes to collect license usage information from FlexNet license management. Defined in lsf.licensescheduler.

LS_ENABLE_MAX_PREEMPT

Enables maximum preemption time checking for taskman jobs. Defined in lsf.licensescheduler.

LS_MAX_TASKMAN_PREEMPT

Maximum number of times taskman jobs can be preempted. Enabled by LS_ENABLE_MAX_PREEMPT. Defined in lsf.licensescheduler.

LS_MAX_TASKMAN_SESSIONS

Maximum number of taskman jobs that run simultaneously. Defined in lsf.licensescheduler.

LSF_LIC_SCHED_HOSTS

List of hosts that are candidate Platform License Scheduler hosts. Defined in lsf.conf.

LSF_LIC_SCHED_PREEMPT_REQUEUE

Specifies whether to requeue or suspend a job whose license is preempted by Platform License Scheduler. Defined in lsf.conf.

LSF_LIC_SCHED_PREEMPT_SLOT_RELEASE

Specifies whether to release the slot of a job that is suspended when its license is preempted by Platform License Scheduler. Defined in lsf.conf.

LSF_LIC_SCHED_PREEMPT_STOP

Specifies whether to use job controls to stop a job that is preempted. Defined in lsf.conf.

LSF_LICENSE_FILE

Location of the LSF license file, which includes License Scheduler keys. Defined in lsf.conf.

PORT

TCP listening port used by License Scheduler. Defined in lsf.licensescheduler.

Examples

blinfo -a displays both NON_SHARED_DISTRIBUTION and WORKLOAD_DISTRIBUTION information:
blinfo -a
FEATURE      SERVICE_DOMAIN  TOTAL  DISTRIBUTION
g1           LS              3      [p1, 50.0%] [p2, 50.0% / 2] NON_SHARED_DISTRIBUTION
                                    [p2, 2]
                                    WORKLOAD_DISTRIBUTION
                                    [LSF 66.7%, NON_LSF 33.3%]
blinfo -a does not display NON_SHARED_DISTRIBUTION, if the NON_SHARED_DISTRIBUTION is not defined:
blinfo -a
FEATURE      SERVICE_DOMAIN  TOTAL  DISTRIBUTION
g1           LS              0      [p1, 50.0%] [p2, 50.0%]
                                    WORKLOAD_DISTRIBUTION
                                    [LSF 66.7%, NON_LSF 33.3%]
g2           LS              0      [p1, 50.0%] [p2, 50.0%]
g33          WS              0      [p1, 50.0%] [p2, 50.0%]
blinfo -a does not display WORKLOAD_DISTRIBUTION, if the WORKLOAD_DISTRIBUTION is not defined:
blinfo -a
FEATURE      SERVICE_DOMAIN  TOTAL  DISTRIBUTION
g1           LS              3      [p1, 50.0%] [p2, 50.0% / 2]
                                    NON_SHARED_DISTRIBUTION
                                    [p2, 2]

Files

Reads lsf.licensescheduler

See also

blstat, blusers