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 (cluster mode and project mode)

-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

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 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.

-o alpha | total

Sorts license feature information by total tokens.

  • 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

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.

-P

When LS_FEATURE_PERCENTAGE=Y or LS_ACTIVE_PERCENTAGE=Y, lists the license ownership (if applicable) in percentage.

-h

Prints command usage to stderr and exits.

-V

Prints the License Scheduler release version to stderr and exits.

Options (project mode only)

-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.

-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.

-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.

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.

MODE

The mode of the license:

Cluster
Cluster mode
Project
Project mode
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.

All output (-a)

As default output, plus all other feature-level parameters defined for each feature.

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)

Parameters Output (-p)

Displays values set in the Parameters section of lsf.licensescheduler.

Displays the following parameter values from lsf.conf:

LS_LOG_MASK or LOG_MASK

Specifies the logging level of error messages for License Scheduler daemons. If LS_LOG_MASK is not defined in lsf.licensescheduler, the value of LSF_LOG_MASK in lsf.conf is used. If neither LS_LOG_MASK nor LSF_LOG_MASK is defined, the default is LOG_WARNING.

For example:
LS_LOG_MASK=LOG_DEBUG
The log levels in order from highest to lowest are:

  • LOG_WARNING

  • LOG_DEBUG

  • LOG_DEBUG1

  • LOG_DEBUG2

  • LOG_DEBUG3

The most important License Scheduler log messages are at the LOG_WARNING level. Messages at the LOG_DEBUG level are only useful for debugging.

LSF_LIC_SCHED_HOSTS

List of hosts that are candidate 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 License Scheduler. Defined in lsf.conf.

LSF_LIC_SCHED_PREEMPT_SLOT_RELEASE

Specifies whether to release the resources of a job that is suspended when its license is preempted by 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.

Allocation output (-A, project mode)

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.

Hierarchical Output (-G, project mode)

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, project mode)

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.

Examples

blinfo -a (project mode) displays both NON_SHARED_DISTRIBUTION and WORKLOAD_DISTRIBUTION information when they are defined:
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%]

Files

Reads lsf.licensescheduler

See also

blstat, blusers, lsf.licensescheduler, lsf.conf