Readme file for IBM® Spectrum LSF License Scheduler 10.1 Fix 602016

Abstract

P105123. This fix introduces a new parameter to control how the blcollect (license collector daemon) command retrieves license usage data from FlexNet license servers.

Description

Readme documentation for IBM Spectrum LSF License Scheduler 10.1 Fix 602016 including installation-related instructions, prerequisites and co-requisites, and list of fixes.

This fix addresses the following issue:

Occasionally, customers experience delays in LSF job scheduling, primarily attributed to delays in license querying by using lmstat or lmutil. This delay occurs because the licensing features utilized by certain resources under LSF License Scheduler management are part of a larger pool of license services, overseeing thousands of features for over ten thousand end users.

Currently, the third-party tools lmstat and lmutil only allow retrieving of all features using the -a option, or a single feature using the -f option. It lacks support for fetching a subset of features from the entire pool. Given that customers utilize only a small set of features from the thousands available, enhancing license monitoring by querying per feature, rather than for all features, can significantly improve efficiency.

This fix introduces the LM_STAT_PER_FEATURE parameter in the Parameters and ServiceDomain sections of the lsf.licensescheduler configuration file to control how the blcollect command retrieves license usage data from FlexNet license servers.

LM_STAT_PER_FEATURE

Syntax

LM_STAT_PER_FEATURE=Y|y|N|n

Description

Controls how the blcollect (license collector daemon) command retrieves license usage data from FlexNet license servers.

When LM_STAT_PER_FEATURE is set to Y, the blcollect command retrieves usage data for individual licenses from the license server using the lmstat or lmutil -f commands, rather than retrieving data for all features using lmstat or lmutil -a commands.

If LM_STAT_PER_FEATURE is set to N, or is not defined, the blcollect command retrieves data for all features by calling the lmstat or lmutil -a commands. LM_STAT_PER_FEATURE only takes effect when the LM_TYPE value is set to FLEXLM. If the LM_TYPE value is set to RLM, then the LM_STAT_PER_FEATURE parameter will be ignored.

Configure the LM_STAT_PER_FEATURE parameter to allow LSF License Scheduler to manage a small set of licenses from a license server that handles hundreds or thousands of licenses. Implementing this parameter may enhance blcollect's data collection capabilities. However, do not use this when License Scheduler manages the bulk of licenses from the license server.

The LM_STAT_PER_FEATURE value set in the. ServiceDomain section of the lsf.licensescheduler file overwrites the one defined in Parameters section. If there is no LM_STAT_PER_FEATURE value defined in the ServiceDomain section, the one defined in Parameters section will be used.

Default

Undefined (N).

 

Readme file for: IBM Spectrum LSF License Scheduler

Product or component release: 10.1

Update name: Fix 602016

Fix ID: LS-10.1-build602016

Publication date: May 15 2024

 

Contents

1. List of fixes

2. Download location

3. Product or components affected

4. System requirements

5. Installation and configuration

6. List of files

7. Product notifications

8. Copyright and trademark information

 

1. List of fixes

P105123

 

2. Download locations

Download Fix 602016 from the following location: https://www.ibm.com/support/fixcentral

 

3. Product or components affected

Affected product or components include:

LSF/bld

LSF/blcollect

LSF/bladmin

LSF/blcstat

LSF/blhosts

LSF/blinfo

LSF/blkill

LSF/blparams

LSF/blstat

LSF/bltasks

LSF/blusers

LSF/libglb.a

LSF/libglb.so

 

4. System requirements

linux2.6-glibc2.3-x86_64

linux3.10-glibc2.17-x86_64

 

5. Installation and configuration

Before you install

Before you apply this fix make sure that you installed LSF License Scheduler 10.1 Fix Pack 12. You can download LSF License Scheduler 10.1 Fix Pack 12 from https://www.ibm.com/support/fixcentral. Search for build600490. Contact IBM LSF Support if you have any questions or problems with installing Fix Pack 12.

LSF_TOP is the full path to the top-level installation directory of LSF.

1.      Log on to the License Scheduler management host as the License Scheduler primary administrator.

2.      Set your environment:
-For csh or tcsh: % source LSF_TOP/conf/cshrc.lsf
-For sh, ksh, or bash: $ . LSF_TOP/conf/profile.lsf

Installation steps

1.      Log on to the License Scheduler management host as the root user and set your environment:
-For csh or tcsh: % source LSF_TOP/conf/cshrc.lsf

-For sh, ksh, or bash: $ . LSF_TOP/conf/profile.lsf

2.      Go to the install directory: cd $LSF_ENVDIR/../10.1/install/

3.      Copy the fix file to the install directory: $LSF_ENVDIR/../10.1/install/

4.      Run patchinstall: ./patchinstall <fix>

After you install

1.      Log on to the License Scheduler management host as the License Scheduler primary administrator and set your environment:

-For csh or tcsh: % source LSF_TOP/conf/cshrc.lsf

-For sh, ksh, or bash: $ . LSF_TOP/conf/profile.lsf

2.      Configure RESTRICT_FEATURE_NAME=Y in parameter section of LSF_TOP/conf/lsf.licensescheduler.

3.      Run bladmin reconfig all

Uninstallation

1.      Log on to the License Scheduler management host as the root user and set your environment:

-For csh or tcsh: % source LSF_TOP/conf/cshrc.lsf

-For sh, ksh, or bash: $ . LSF_TOP/conf/profile.lsf

2.      Go to the install directory: cd $LSF_ENVDIR/../10.1/install/

3.      Run ./patchinstall -r <fix>

4.      Log on to the License Scheduler management host as the License Scheduler primary administrator and set your environment:

-For csh or tcsh: % source LSF_TOP/conf/cshrc.lsf

-For sh, ksh, or bash: $ . LSF_TOP/conf/profile.lsf

5.      Remove the RESTRICT_FEATURE_NAME parameter if defined in parameter section of LSF_TOP/conf/lsf.licensescheduler.

6.      Run bladmin reconfig all

 

6. List of files

The following components in all Linux and Unix packages:

LSF/bld

LSF/blcollect

LSF/bladmin

LSF/blcstat

LSF/blhosts

LSF/blinfo

LSF/blkill

LSF/blparams

LSF/blstat

LSF/bltasks

LSF/blusers

LSF/libglb.a

LSF/libglb.so

 

7. Product Notifications

To receive information about product solution and fix updates automatically, subscribe to product notifications on the My notifications page (www.ibm.com/support/mynotifications) on the IBM Support website (support.ibm.com). You can edit your subscription settings to choose the types of information you want to get notification about, for example, security bulletins, fixes, troubleshooting, and product enhancements or documentation changes.

 

8. Copyright and Trademark Information

©Copyright IBM Corporation 2024

U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

IBM®, the IBM logo, and ibm.com® are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.